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The title of this publication, formerly 
Control Program with MFT, Program Logic 


the fact that the document now descripes 


the MFT level of job management only. The 
information formerly contained in the 
"Introduction" and the “Initialization of 
the Operating System" sections of this 
publication may now be found in the MrL 
Guide, GCz7-6939. The information formerly 
contained in the "Supervisor" section of 
this puplication may new be found in the 
MFT Supervisor, PLM, GY27-6736. 


This publication describes the internal 
logic of the MfT level of job management, 
its functions, and the control flow among 
its routines, as MFT job management differs 
from MVT job management. It presents a 
brief description of each element of job 
Management logic and then indicates if that 
logic is the same as the corresponding 
logic in MVT job management. If it is the 
same, the reader is directed to the 
publication that contains a detailed 
description of the MVT logic. Elements of 


job management logic that are unique to the 


MFT configuration of the control program 
are described in detail in this 
publication. 


The manual is divided into five major 
parts. The "Introduction" priefly 
describes MFT job management in terms of 
the various elements used to perform the 
system initialization, job processing, and 
command processing functions. It also 
includes a discussion of job management 
control flow. Parts 1-4 contain a 
description of these functions and the 
common elements of job management. They 
indicate the areas of logic that are common 


Preface 


to MFT and MVT, and describe the processing 
unique to MFT. 


Appendix A contains descriptions of the 
major tables and work areas used by MFT job 
management. Appendix B contains 
descriptions of the modules used by MFT 
Management and includes a table of modules 
that are unique to MFT, a series of cables 
listing the modules used by MFI according 
to major component, and a module cross 
reference listing. Appendix C contains MFT 
job management flowcharts. Appendix D 
contains the acronyms used in the text of 
the publication. 


Readers should have a thorough knowledge 
of ITEM System/360 programming and should be 
familiar with the basic operation of job 
management for the MVTIT configuration of the 
control program. Knowledge of the 
information in the following publications 
is required for a full understanding of 
this manual: 


IsM System/360 Operating System: 
MFT Guide, GC27-6939 


MVI Job Management, PLM, GY28- 6660 


This publication makes reference to the 
following publications: 


IBnM System/360 Operating System: 
IPL/NIP, PLM, GY28-6661 
MFT Supervisor, PLM, GY27-7236 
Operator's reference, GC28-6691 
System Control Blocks, GC28-6628 
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NEW PROGRAMMING FEATURES 


Status Display Support 
The following task-creating commands 
have been added to the COMMAND 
PROCESSING section: DISPLAY PFK, 
DISPLAY C,K; MONITOR A. 


The following existing-task commands 
have been added to the COMMAND 
PROCESSING section: MSGRT; STOPMN; 
CONTROL. the operands in the following 
list have peen moved from the STOP 
command to the STOPMN command: DSNAME, 
SPACkL, JOBNAMES, STATUS, SESS. Note: 
For release 21, the system will 
continue to recognize these operands as 
valid for use with the STOP command as 
well as for the STOPMN command. 


Summary of Amendments 
for GY2/7-7128-7 
OS Release 21 


Console Dump Command 
A new SVCLI5 module has been added to 
provide for dumping of main storage to 
a pre-allocated data set, SYS1.DUMP. 


Display SQA Command 
A new SVC 34 command has been added to 
display the system queue area. 


Master Scheduler _initialization _Routine 
Sections of this routine have been 
rewritten. 





Reply Processor for Non-MCS _ 


An SVC 34 routine for non/McS 
Environments has peen added. 
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OS Release 20.1 
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CSCB Size Reduction 
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jcommands in an MCS en- 

j vironment. 


| ITEE3503D has been modified 
jto process the MONITOR 

| (DSNAME , JOBNAMES , SPACE, 
|STATUS) commands. 
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| reader queue, a new sSubqueue | 
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The primary job management function is to 
prepare job steps for execution and, when 
they have been executed, to direct the 
disposition of data sets created during 
execution. Prior to step execution, job 
management: 


® Reads control statements from the input 
job stream 


e Places information contained in the 
statements into a series of tables. 


e Analyzes input/output requirements. 

e ASSigns input/output devices. 

e Passes control to the jop step. 
Following step execution, job management: 


e Releases main storage space occupied by 
the tables. 


e Frees input/output devices assigned to 
the step. 


6 Disposes of data sets referred to or 
created during execution. 


Job management also performs system 
initialization functions and the processing 
required for communication between the 
Operator and the control program. Job 
Management functions may be divided into 
three major categories: system 
initialization, job processing and command 
processing. 


System Initialization 


The master scheduler task, which performs 
the system initialization function, is 
established by the nucleus initialization 
program (NIP). (See the IPL/NIP PLM) The 
master scheduler initialization routine 
receives control after the nucleus 
initialization program completes the 
definition of the fixed area of main 
storage. It passes control to the routines 
that initialize console communications, the 
Optional system log, the job queue, and the 
Optional system management facility, and 
define the partitions in the dynamic area 
of main storage. 


Introduction 


Job Processing 


Job processing is performed by the 
reader/interpreter, the 
initiator/terminator, the system output 
writer, and direct system output (DSO) 
processor. The functions of the 
reader/interpreter are Similar to those of 
the MVT reader; additional information can 
be found in the MVT Jov Management PLM. 


After all control statements for a job 
have been processed, all initiators that 
are waiting for that job class are posted 
and the initiator residing in the highest 
priority partition is given control. The 
MFT initiator is described in the "Joo 
Processina™ section of this publication; 
for information on allocation and 
termination, refer to the MVT Job 


Management PLM. 


When the job step has been executed, 
control is returned to the 
initiator/terminator which performs data 
set dispositions and releases input/output 
(I/O) resources. If the entire job is to 
be terminated and DSO was not used, the 
terminator engqueues all data sets on the 
appropriate system output (SYSOUT) queues. 


When the system output writer receives 
control, it dequeues a job from an output 
queue, and transcribes the data sets to the 
user-specified output device. (See the MVT 
Job Management PLM for further information 
on the system output writer.) 


Command Processing 


Command processing is performed by the SVC 
34 command scheduler routines, the master 
scheduler resident command processor 
routines, and the system task control 
routines. The SVC 34 command scheduler 
routines process all commands initially. 
The joo queue manipulation and partition 
definitions, which are not fully processed 
by SVC 34, are passed to the master 
scheduler resident command processor. 
START commands are processed by the system 
task control routines. Figure 1 lists the 
commands used in MFT and indicates the 
routine which responds to the commands 
after initial processing. 
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Figure 1. Response to Commands After Initial Processing (Part 2 of 2) 


Job Management Control Flow 


Figure 2 shows the major components of job 
management and the general flow of control. 


Control is passed to job management 
whenever the supervisor finds that there 
are no program request blocks in the 
request block queue. This can occur for 
two reasons: either the initial program 
loading (IPL) procedure has just been 
completed, or a job step has just been 
executed. 


Entry to Job Management After Initial 
Program Loading 


After IPL, certain actions must be taken by 
the operator before job processing can 
begin. Therefore, control passes to the 
communications task which issues a message 
to the operator instructing him to enter 
commands, or to redefine the system. If he 
chooses to redefine the system, control 
passes to the master scheduler task to 
handle the redefinitions. If not, the 
initialization commands (START reader, 
START writer, and START INIT) are issued 
either automatically by the master 
scheduler task or by the operator 


performing the IPL (see the "Initialization 
Z and Restart" section), and job processing 
‘ begins. 
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Figure 2. Joo Management Data Flow 


Entry to Job Management After Step 
Execution 


After step execution, control is passed to 
the step termination routine of the 
initiator/terminator. If no further job 
steps are to be processed, control is also 
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When the operating system is loaded, it 
must be initialized to conform to the 
locations and extents of the system data 
sets, and to the requirements of the 
installation. This process, which includes 
formatting the work queue data set, is 
called system initialization. If the work 
queue data set is already in the proper 
format, special processing must be 
performed to purge the work queues of 
incomplete and inappropriate entries; in 
this case, the processing is called system 
restart. 


System Initialization 


There are some major differences in the 
system initialization processing performed 
for MFT and MVT configurations of the 
control program. In MFT, the master 
scheduler initialization routine 
(TEFSD569), Operating under control of the 
master scheduler TCB, initializes the 
dynamic area Of main storage. In MVT, this 
is accomplished by the nucleus 
initialization program (NIP). In MFT, it 
is done by the master scheduler to 
facilitate the redefinition of main 
storage. 


The master scheduler initialization 
routine (I#EFSD569) described below is 
unique to the MFT configuration of the 
control program. (For a discussion of the 
initialization processing performed before 
the master scheduler initialization routine 
receives control, see: the IPL/NIP PLM and 
the MFT Guide.) | 


The master scheduler initialization 
routine (Chart 05) first passes control to 
the communications task initialization 
routine (IEECVCTI) via a LINK macro 
instruction. (See the MFT Supervisor PLM.) 
After the communications task is 
initialized, the master scheduler 
initialization routine passes control to 
the definition routine, IEEDFIN1I, via a 
LINK macro instruction. IEEDFIN1 
communicates with the operator, or prepares 
the partition as it was described at system 
generation. 
message, and if the system log was 
reguested, passes control to I[EEVLIN to 
initialize the system log. (See the MFT 
Supervisor PLM.) It then types the 
automatic commands, and issues a WAIT macro 
instruction. 


PART 1: 


IEFSD569 then issues the READY 


INITIALIZATION AND RESTART 


When the operator presses the REQUEST 
key, control is given to the Supervisor, 
which recognizes the interruption and 
passes control to the input/output 
supervisor. The input/output supervisor 
determines that the interruption is an 
attention signal and passes control to 
communications task console attention 
interrupt routine. The interrupt routine 
posts the communications task attention ECB 
to request reading of the console. The 
operator enters a SET command. SVC 34 
posts the WAIT and places the parameters of 
the SET command in the master scheduler 
resident data area. The master scheduler 
initialization routine then regains control 
to continue processing. Control blocks for 
the joo queue and procedure library are 
created. To format the job queue, the 
routine passes control to queue 
initialization routine IEFSD055 via a LINK 
Macro instruction which, places a queue 
control record (QCR) in the nucleus after 
the DCB and DEB. Control then passes to 
queue manager formatting routine IEFORMAT, 
which formats the job queue and returns 
control to the queue initialization 
routine. (For a discussion of these two 
modules, see the topic "Work Queues."™) 
After return from the queue manager 
initialization routine, the master 
scheduler initialization module passes 
control to IEEVPRES for the initialization 
of volume attributes for all tape and 
direct access devices. The master 
scheduler initialization routine then 
displays and processes any automatic 
commands. 


If the system management facility is 
specified, the routine stores the SMF 
options in the first byte of the CVTSMCA 
field of the CVT. It then passes control 
via a LINK macro instruction to SMF 
initialization routine IEESMFIT to 
initialize the system management facility. 
(See the “SMF Initialization" topic in the 
"Common Elements of Job Management" section 
in this publication.) 


The master scheduler initialization 
routine then establishes partitions based 
on information in the TCBs. It constructs 
an RB in each partition, with an XCTL macro 
instruction addressing job selection module 
IEFSD510 (for large partitions), or small 
partition module IEFSD599 (for small 
partitions). The master scheduler 
initialization routine then returns control 
to the dispatcher. The dispatcher returns 
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control to the master scheduler task, but 
the TCB now points to master scheduler 
resident command processor routine IEECIR50 
in the nucleus. 


System Restart 


The system restart functions may be 
reguested at any time that a system restart 
becomes necessary; e.g., end-of-day, 
end-of-shift, when a system malfunction 
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occurs, Or when power fails. This feature 
provides a means of preserving a maximum 
amount of information concerning input work 
queues, Output work queues, and jobs in 
interpretation, initiation, execution, or 
termination. System restart permits 
reinitialization, rather than a complete 
reformatting, of the job queue data set 
(SYS1.SYSJOBQOE). 


MFT uses the MVI system restart modules. 
For a complete description of these 
modules, and how they function, see the MVT 


Job Management PLM. 








Job processing is accomplished by three 
types of tasks: 


e Reading tasks, which control the 
reading of input job streams and the 
interpreting of control statements in 
these input streams. 


e Initiating tasks, which control the 
initiating of job steps whose control 
Statements have been read and 
interpreted. (Terminating procedures 
are also part of initiating tasks.) 


e Writing tasks, which control the 
transferring of system messages and 
user data sets from direct-access 
volumes on which they were written 
initially to some other external 
storage medium. 


These tasks are created in response to 
START commands entered for readers, 
initiators, and writers. Whenever a START 
reader or writer command is entered, the 
resulting command processing brings a 
reader or writer into the associated 
partition. Initiators are brought into all 
scheduler-size partitions at system 
initialization, and after a START INIT 
command has been issued following partition 
redefinition. An initiator is also brought 
into a partition that is specified in a 
START command issued for a problem program. 
See the "System Task Control" section of 
this publication for a description of START 
commands issued for problem programs. 


There may be more than one of each of 
the job processing tasks so long as the 
total does not exceed 52. Input job 
Streams may be read simultaneously from 
three input devices by issuing a START 
reader command for each input stream. 
System messages or data sets may be written 
by system output writers to as many as 36 
Output devices by issuing a START command 
for each device. Up to 15 initiating tasks 
Can exist concurrently. Each initiating 
task is created in response to a START INIT 
command issued for a specific partition, or 
a START INIT.ALL command. In addition, 
each problem program may use direct system 
Output (DSO) processing. DSO is started by 
entering a START DSO command for a 
partition naming a system output class and 
a.device. DSO processing is limited only 
by the number of available devices. (See 
the Operator's Reference, GC28-6691). 


PART 2: JOB PROCESSING 


Reader /Interpreter 


MFT uses the MVT reader/interpreter 
(reader). However, because of job class, 
possible MFT interlocks, and the capability 
of using transient readers, some 
modifications have been made to the MVT 
modules, and six new modules have peen 
aaded. These modifications and additions 
are described pnelow. 


MFT allows as many as three input 
readers to execute concurrently with 
problem programs and writers. Resident 
readers operate in previously defined 
reader partitions, and transient readers 
operate in problem program partitions large 
enough to accommodate them. input stream 
data for the step being read is transcribed 
onto direct-access storage where it is held 
until execution of the associated joo 
begins. Problem programs retrieve this 
data directly from the storage device. 


In MFT there are three typves of system 
input readers: 


e Resident reader. 
e User-assigned transient reader. 
e System-assigned transient reader. 


Resident and transient readers may operate 
in the same system, provided no more than 
one system-assigned reader is specified, 
and the total number of readers does not 
exceed three. The primary difference 
between the user-assigned and 
system-assigned transient readers is the 
Manner in which the transient reader 
resumes operation after it is suspended. 


RESIDENT READERS 


A resident reader operates in a partition 
designated as such at system generation (by 
replacing the job class identifier with R), 
or during system initialization or 
partition definition (by specifying RDR for 
the job class identifier). A resident 
reader reads its input stream, enqueuing 
jobs until the input stream reaches 
end-of-file or until it is terminated by a 
STOP command entered for that partition. 


Note: The STOP command does not take 
effect until the current job is completely 
read. 
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TRANSIENT READERS 


A transient reader operates in a problem 
program partition large enough to 
accommodate it. A transient reader can be 
terminated by issuing a STOP command or by 
reaching end-of-file, as can the resident 
reader. In addition, a transient reader is 
suspended when a job is engqueued either for 
the partition occupied by the reader, or 
for a smali partition. (Note that this is 
possible only when a reader completes 
reading an entire job.) 


If a transient reader is started ina 
specific partition by including the 
partition assignment in the START command, 
it always resumes operation in that same 
partition, and only when that partition be- 
comes free. This type of transient reader 
is referred to as user-assigned. If ‘'S' is 
substituted for the partition number in the 
START command, the system assigns the 
reader to any available large problem 
program partition. This type of transient 
reader is called system-assigned. 





READER CONTROL FLOW 


After a START command is entered to 
activate a reader, the master scheduler 
resident command processor routine IEECIR50 
determines if the size of the requested 
partition is large enough, and posts the 
partition. Job selection routine IEFSD510 
determines that a START command has been 
entered, and passes control to system task 
control (STC). The STC syntax check 
routine validates the syntax of the START 
command, builds job control language 
tables, and retrieves the reader cataloged 
procedure specified in the START command. 
Hach reader is assigned to an input device 
specified in the START command. Control is 
then passed to interface routine ILEFSD533 
which sets up an interpreter entrance list 
(NEL) for a reader. It also allocates job 
queue space for a transient reader by 
issuing a dummy WRITE macro instruction. 
Control is then passed to linkage routine 
LTEFSD537 which issues a LINK macro 
instruction to reader initialization 
routine IEFVH1 to begin reading the input 
job stream (Chart 10). 


When reader initialization routine 
IEFVH1 receives control, it reads its input 
stream using QSAM, and translates job 
processing information into convenient form 
for subsequent processing by an initiator 
and system output writer. Each job read in 
by the readers is converted into tables 
that are placed in the appropriate job 
class input work queue specified by the 
CLASS parameter on the JOB statement. One 
input work queue exists for each of the 
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fifteen problem program job classes (A 
through O). 


For systems that include Multiple 
Console Support (MCS), the PARM field on an 
EXEC statement includes a command authority 
code. This code is included in the option 
list created py interface routine IEFSD533, 
and placed in the interpreter work area 
(IWA) by reader initialization routine 
IEFVH1. This code is passed by the reader 
when it issues an SVC 34 due to a command 
read in the input stream. 


After the reader has completed reading a 
joo, control passes to queue manager 
enqueue routine IEFQMNGOQ which enqueues the 
job on the appropriate input work queue 
according to the PRTY parameter on the JOB 
statement (see “Queue Management" in this 
section). 


Note: If the reader is being used as a 
subroutine by a problem program, it does 
not enqueue the job on the input work 
queue, but returns control to the problem 
program passing the addresses of the JCT 
constructed for that job, and the QMPA 
associated with that input gueue entry. 


If data is encountered in the input 
stream, control is passed to interpreter 
CPO routine IEFVHG to transcribe the data 
onto direct-access storage for later 
retrieval by the problem program. If there 
is no space for the data, control passes to 
interpreter operator message routine 
IfFSD536 to issue a DISPLAY active command 
and a WTOR message. The operator replies 
with either "WAIT' or ‘CANCEL'. If ‘'WAIT' 
is specified, the reader waits for space to 
become available. If '"CANCEL' is 
specified, the reader is canceled anda 
READER CLOSED message is issued. IEFSD536 
then sets indicators which cause cleanup of 
the current job, and control to be passed 
to interpreter termination routine IEFVHN 
to terminate the reader. 


After a reader engqueues each job, 
control passes to transient-reader suspend 
tests routine IEFSD532. This routine 
decides whether to 1) terminate the reader, 
2) suspend the reader, or 3) have the 
reader continue reading the job stream. 
(The decision to suspend the reader would 
never be made if the reader is resident.) 
If the reader is to be terminated, control 
passes to termination routine IEFVHN. If 
the reader is to be suspended, control 
passes to transient reader suspend routine 
IEFSD530. Otherwise, control returns to 
job and step enqueue routine IEFVHH to 
continue reading the job stream. 








Transient Reader Suspend Routine (IEFSD530) 


When a transient reader is suspended, 
transient reader suspend routine IEESD530 
(Chart 13) writes the tables and work areas 
used by the reader onto the work queue data 
set (SYS1.SYSJOBOE). 


The routine closes the reader and 
procedure library. Data needed to restore 
the reader is temporarily saved in the 
interpreter work area (iWA). The IWA is 
then written to the work queue data set. 
When a user-asSigned transient reader is 
suspended, the address of the reader space 
On the work queue is placed in tne 
partition information block (PIB). 
system-assigned transient reader is 
suspended, the address of the IWA is placed 
in the master scheduler resident data area 
(IEESD568). (See Appendix A for the format 
of the master scheduler resident data 
area.) ‘The work queue data set is later 
used by transient reader restore routine 
ITEESD531 to restore the reader when the 
assigned partition becomes available after 
job termination. "No work" ECBs for 
problem program partitions are posted (see 
"Job Selection"), and the JCTJMR field of 
the JCT is tested to determine if SMF is 
supported. If this field contains zeroes, 
there is no job management record (JMR) and 
SMF is not supported. 
the user's SMF exit routine IEFUJV (whose 
address is contained in the JMRUJVP field 
of the JMR) is deleted if it is present in 
main storage. Storage for the JMR is also 
freed via the FREEMAIN macro instruction. 


When a 


The transient reader suspend routine 
then returns control to system task 
control. 


Note: See the MVT Job Management PLM for 
the format and description of the JMR. 


Transient Reader Restore Routine (ITEFSD531) 


Once a partition is again free for the 
reader, transient reader restore routine 
IEFSD531 (Chart 14) receives control and 
issues a GETMAIN for the IWA, Local Work 
Area (LWA), reader DCB, and procedure 
library DCB. The direct-access device 
address of the IWA is retrieved from the 
PIB if a user-assigned reader is to be 
restored, or from the master scheduler 
resident data area, if a system-assigned 
reader is to be restored. The IWA is then 
read in from the job queue. The TIOT is 
read into storage and the TCB pointer is 
updated; other tables and work areas 
necesSary to restore the reader are reset 
from the information saved in the IWA. 


If SMF is in the system and if SMF 
options are specified, a GETMAIN macro 
instruction is issued to obtain main 


If SMF is supported, 


storage for the job management record 
(JMR). The JMR is then initialized with 
the SMF options and the RDR device type and 
name. If SMF exits are specified, the name 
of SMF user exit routine IEFUJV is placed 
in the interpreter entrance list (NEL). 

The routine is then loaded and its address 
is placed in the JMRUJVP field of the JMR. 
The reader and procedure library DCBs are 
opened and the reader resumes operation to 
Start reading at the point in the job 
Stream where it was suspended. Control is 
then passed to interpreter routine IEFVHCB 
to continue reading the job stream. 


Initiator/Terminator (Scheduler) 


To provide independent scheduling, 
schedulers operate in any problem program 
partition of sufficient size. A partition 
large enough to accommodate the scheduler 
is referred to as a “large partition." A 
partition not large enough to accommodate 
the scheduler is referred to as a “small 
partition". Within a given large 
partition, a scheduler operates 
independently of schedulers in other large 
partitions. Because small partitions 
cannot accommodate the scheduler, they rely 
on large partitions to perform their 
initiation, allocation, and termination 
operations. Scheduling for small 
partitions is described in "Small Partition 
Scheduling" in this section. 


An MFT initiator (Chart 8) dequeues a 
job (entry) for its partition based on a 
job class designated for the partition. 
Once dequeued, the job is scheduled 
according to the information contained in 
the entry. 


During allocation and termination of 
each job step, the allocation and 
termination routines place messages and 
output data set pointer blocks ina 
specified output queue. The queue entry is 
created by the reader/interpreter. (The 
output queue entry becomes input to an 
output writer when the job is completed.) 


An initiator functions as a control 
program for the scheduling process, using 
the allocation and termination functions as 
closed subroutines. (See Figure 3 for an 
illustration of the scheduling process ina 
large partition.) The MFT initiator is 
composed of the following routines: 


e Job Selection 

e Small Partition 

e Job Initiation 

e Data Set Integrity 
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Step Initiation 

Problem Program Interface 
Step Deletion 

ENQ/DEQ Purge Routine 
Alternate Step Deletion 


Job Deletion 
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Figure 3. Scheduling a Problem Program 
Entered Through the Input 


Stream ina Large Partition 


JOB SELECTION (IEFSD5i10) 


“The job selection routine (Chart 9)acts as 
the control routine for the MFT initiator. 
The routine is brought into all large 
problem program partitions by the master 
scheduler at system initialization, by the 
job deletion routine when a job has 
terminated, or by system task control when 
a system task has been scheduled for a 
small partition or a system task has been 
suspended. 


Job selection first waits on a "no work" 
ECB in the PIB. This ECB is posted 
complete by the command processing 
routines, the job deletion routine, system 
task control, or the small partition module 
when a small partition needs scheduler 
services. 
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When the “no work" ECB has been posted 
complete, the job selection routine checks 
the PIB to determine if a life-of-task 
(LOT) block exists (see Appendix A for a 
description of the LOT block). If not, it 
creates one for the task. 


Job selection then checks the PIB for a 
small partition information list (SPIL) 
pointer (see Appendix A for a description 
of SPILL). If one exists, scheduling is 
performed for the small partition by 
passing control to IEFSD599. If no SPIL 
pointer exists, the PIB is checked for any 
pending STOP DSO or MODIFY DSO commands. 
These are processed by passing control to 
stop and modify command processing routine 
ITEFDSOSM. 


Upon return from IEFDSOSM, the PIB is 
checked to determine if the partition is 
involved in partition redefinition; if the 
partition is to be changed, the PIB is 
checked further.. If a job is queued on the 
checkpoint/restart internal queue it is 
processed; if a restart reader is pending, 
it is started. If neither exists, any DSO 
processing is stopped, no further 
scheduling is allowed in the partition and 
the partition can be redefined. (See “The 
Master Scheduler Resident Command 
Processor."™) 


If the partition in which the initiator 
is operating is not part of a partition 
redefinition, a test is made for a pending 
Restart Reader command. If no command is 
pending, a test is made to determine if a 
system task is to be started. If a restart 
reader or a system task is to be started, 
control passes to system task control. If 
a restart reader is being started, anda 
user-assigned reader had been rolled out of 
the partition, the PIB is marked 


accordingly. 


If no small partition is requesting 
service, no system task is to be started, 
and the partition is not part of a 
redefinition operation, a final check is 
made to determine if a START INIT command 
has been issued; if so, job selection 
attempts to dequeue work from the input 
work queue. If a STOP INIT command has 
been issued, the attempt to dequeue a job 
is bypassed. 


A threshold check is then made to 
determine if enough logical tracks are 
available on SYS1.SYSJOBQE to start the 
initiator. If not, message IEF427I COMD 
REJECTED FOR INITIATOR ‘ident' - 
INSUFFICIENT QUEUE SPACE is sent to the 
operator and job selection again waits on 
the “no work" ECB. 


The job selection routine obtains 
Storage for the job control table (JCT) 








andchecks to determine if a job is queued 
on the checkpoint/restart internal queue. 
If a job exists, dequeue by jobname routine 
(IEFLOCDQ) is used to remove it from the 
hold queue for processing. If no job is on 
the internal queue, the routine then uses 
the queue manager dequeue routine 
(LEFOMDOU) to obtain work from one of the 
input job queues according to the job class 
assignment of the partition. If work is 
found, IEBFOMDOD constructs a CSCB for the 
job and an I0B to be used when reading or 
writing the input queue. The CSCB is 
constructed in the system queue area and 
the address of the CSCB is placed in the 
LCT. The address of the IOB is placed in 
the queue manager parameter area (QMPA). 
When a user accounting routine is supplied, 
the job selection routine sets all four 
fields of the timer work area in the LCT to 
zero. These fields are used in calculating 
the execution time of a job step. Job 
selection then branches to job initiation 
routine IEFSD511. 


If the search for work for the partition 
is unsuccessful (1.e., no work has been 
engueued for any of the job classes 
assigned to the partition) tests are made 
to determine if a transient reader is to be 
restored in the partition or if a START 
command has been entered fora 
system-assigned transient reader. If so, 
system task control is called. If a reader 
is to be restored in the partition, job 
selection passes control to system task 
control linkage routine IEFSD588. 


Command Processing Services 


In response to commands entered in the 
input stream or from a console, the command 
processing routines request a service by 
storing information in the PIB of the 
affected partition or in the master 
scheduler resident data area for START and 
STOP commands issued for system-assigned 
transient readers and writers. The job 
selection routine recognizes these requests 
and takes one of the following actions: 


e Inhibits further job scheduling for the 
partition in preparation for the 
processing Of a DEFINE command. (The 
DEFINE command can be entered only from 
a console.) 

e Prevents execution of problem programs 
in largé partitions in response to 
either a STOP INIT command specifying a 
particular partition or a STOP INIT.ALL 
command. 

e Passes control to system task control 
(STC) in response any START command 
other than a START INIT command. 

e Schedules problem program execution in 
response to either a START INIT command 
Or a START command issued for a problem 
program in that partition. 


SMALL PARTITION SCHEDULING 


A partition is defined as "small" when its 
Size is at least 8K bytes but less than the 
job scheduler generated for the system. 
Small partition scheduling is performed: by 
an initiator in a scheduler-size partition 
at the request of small partition module 
IEFSD599 (IEFSD599 is described later in 
the topic “Small Partition Module"). The 
small partition is therefore temporarily 
dependent on a large partition while 
scheduler services are being performed. 
Scheduling for a small partition is 
independent of scheduling for other small 
partitions in the system. 


The smail partition module interfaces 
with job selection module IEFSD510 to 
schedule a proodlem program or to establish 
an interface with system task control for 
the scheduling of a system task ina small 
partition. Communication between the small 
partition module and IEFSD510 or system 
task control is maintained through a snall 
partition information list (SPiL). (The 
format of a SPIL is shown in Appendix A.) 


Small partition module IEFSD599 requests 
the scheduling function by placing the 
address of a SPIL in the partition 
information block (PIB) of each 
scheduler-size partition in the system. 
Each time that job selection module 
IEFSD510 is entered between jobs, it checks 
the PIB for a nonzero SPIL address. If the 
PIB contains a valid SPIL address, IEFSD510 
performs one of the following services for 
the small partition: 


e it tests to determine if there is work 
for the small partition and if so, 
IEFSD510 passes control to job 
initiation routine IEFSD511. If not, 
it notifies the small partition 
accordingly. 


e If the small partition is waiting for 
termination services, IEFSD510 passes 
control to step deletion routine 
IEFSD515. 


e If a START command has been entered on 
the console specifying a system task or 
a problem program in a small partition, 
IEFSD510 passes control to system task 
control. 


These routines perform the requested 
service in the large partition and use the 
SPIL to indicate their action to IEFSD599. 
When the requested service has been 
performed, these routines return to 
IEFSD510. 
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Initiating a Problem Program 


As shown in Figure 4, initiation of a 
problem program in a small partition is 
performed by a large partition. If a small 
partition iS waiting for work, job 
selection module IEFSD510 dequeues a job 
from an input work queue that the small 
partition is assigned to service. The 
large partition posts a completion code in 
field ECBA of the SPIL when initiation 
services have been performed. 


A completion code of one indicates that 
no work was found for the small partition. 
The small partition then waits on the ECB 
list in the SPIL. The posting of any of 
the listed ECBs causes the small partition 
to request initiation services. 


A completion code of zero indicates that 
initiation services have been performed and 
the problem program job step is ready to be 
executed. The small partition, uSing the 
allocate parameter list (APL), moves the 
task input/output table (TIOT) and 
life-of-task (LOT) biock from the Large 
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Figure 4. Scheduling a Problem Program Entered Through the Input Stream in a Small Partition ~ 
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partition, opens required DCBs, and 
establishes problem program mode. (1f the 
system has the storage protection feature, 
the protection key is set.) If the job has 
not been canceled, control passes to the 
problem program, thus freeing the large © 
partition to continue processing. 


Initiating a System Task 


As shown in Figure 5, if a system task is 
to be started in the small partition, small 
partition module IEFSD599 requests the 
services of job selection module IEFSD510 
for initiation of the system task. 

IEFSD510 responds to the request by 
bringing the first system task control 
(STC) module into the large partition. STC 
performs the initiation functions up to the 
point of passing control to the system 
task. STC write TIOT routine 1IEFSD590 then 
posts the ECSA in the SPIL witha 
completion code of zero to indicate to 
I&FSD599 that initiation services have been 
performed, and that the system task is 
ready to be executed. The small partition 
module then uses the link parameter list 


SMALL 
PARTITION 


PROBLEM 


PROGRAM 





ABEND 


LARGE 
PARTITION 





TERMINATION 





(LPL) to move the TIOT from the large 
partition to the small partition. It posts 
the ECBC in the SPIL, thus freeing the 
large partition to continue normal 
processing. IEFSD599 then frees the main 
storage occupied by the SPIL and passes 
control to the system task via linkage 
modules L#F589SP, IEFSD584, and IEFSD591. 
(See Chart 17). 


ee ete tet en a 


When the job step is completed, or a writer 
is stopped, small partition module ITEFSD599 
is brought back into the partition and 
entered at special entry point SMALLGO. A 
check is made to determine whether a 
scheduler ABEND occurred. If it did, a 
message is issued to the operator with a 
completion code, and all CSCBs associated 
with that job are removed from the CSCB 
chain. Control then passes to the normal 
entry point of IEFSD599. If no scheduler 
ABEND occurred, IEFSD599 determines if job 
step timing is being performed by testing 
the high-order bit in the job step timing 
status bits field of the PIB. If the bit 
is on, the TQE is being used for job step 
timing and the routine issues a TTIMER 
macro instruction to stop the timing and to 
Obtain the step time remaining for use in 
updating the SPIL. It then turns off the 
bit and saves the step time remaining in a 
register until the SPIL is created. When 
the SPIL is created, the routine updates it 
with the step time remaining and sets the 
Status bit indicating that termination 
services are requested. The small 
partition module then begins a search for a 
large partition to perform the job 
termination required. 


After an initiator ina large partition 
has performed the termination services, 
ECBA in the SPIL is posted with a 
completion code of two to indicate that job 
termination has taken place. A check is 
made to determine if the small partition is 
involved in a redefinition Operation. If 
it is, the small partition is made 
quiescent. If the small partition is not 
associated with a redefinition operation, 
it requests additional services from an 
initiator ina large partition. 


Note: If the initiator ina large 
partition performs step termination instead 
Of job termination, the next step of the 
job in the small partition is scheduled 
before the initiator schedules a job into 
its partition, or before it performs 
scheduling services for another small 
partition. 


Small Partition Module (IEFSD599) 


Small partition module IEFSD599 (Chart 1) 
is entered from the redefinition routines 


at system initialization or when a DEFINE 
command iS issued or from the master 
scheduler. The module is entered at 
Special entry point SMALLGO from the ABEND 
routines when a step has completed 
execution. IEFSD599 first waits ona “no 
work" ECB located in the partition's PIB. 
When this ECB is posted complete, the PIB 
is checked to determine if a SPIL has peen 
created. If not, one is created and an 
indicator is set inthe PIB. The PIB is 
then checked for pending STOP DSO or MODIFY 
DSO commands. IEFSD599 passes control to 
Stop and modify command processing routine 
IEFDSOSM to process any such pending DSO 
commands. 


Upon return from IEFDSOSM, IEFSD599 
checks the PIB to determine if the 
partition is involved ina redefinition 
Operation. If a redefinition is pending, 
the internal job queue of 
checkpoint/restart jobs is checked and any 
joos on the queue are processed before the 
partition redefinition. If there is 
nothing on the internal job queue and 
redefinition is pending, assigned tracks 
are deleted, the SPIL is freed, any DSO 
processing is stopped, and pending CSCBs 
are freed. The ‘DEFINE' ECB in the PIB is 
posted to indicate that the partition has 
been made quiescent, and a return is made 
to wait on the “no work" ECB. 


If no redefinition operation is pending, 
the PIB is checked to determine if a system 
task is to be started in the partition. If 
SO, an indicator is set in the SPIL, 
aSSigned tracks are deleted, and a request 
for scheduling is made to a large partition 
(described below). If a system task is not 
to be started, the STOP INIT bit in the PIB 
is checked. If this bit is on, assigned 
tracks are deleted, the SPIL is freed, and 
a return is made to wait on the ‘no work' 
ECB. If the STOP INIT bit is not on, the 
PIB is checked for track assignment. If 
needed, tracks are assigned and indicated 
in the PIB. The SPIL is updated to 
indicate a request for initiation of a 
problem program. 


A request is made for a large partition 
to service the small partition based on the 
contents of the SPIL. First, an exclusive 
ENQ macro instruction is issued to prevent 
concurrent service requests by small 
partitions. Interruptions are disabled to 
prevent interference with the address of 
the SPIL in the large partition's PIB. 
IEFSD599 then searches for a scheduler-size 
partition. The TCBs are tested for problem 
program status; when a scheduler-size 
partition is found, a determination is made 
of whether the small partition is involved 
in a DEFINE operation. 
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Figure 5. 


If the small partition is involved ina 
DEFINE operation, the test for the large 
partition involved in a DEFINE operation is 
bypassed. If the small partition is not 
involved ina DEFINE operation, the large 
partition is tested to determine if it is 
involved ina DEFINE operation. If so, the 
large partition is bypassed and the TCB 
search is continued. 


The address of the SPIL is stored in the 
PIB of the large partition, thus 
constituting a request. An indication is 
made when storing occurs. If a large 
partition is waiting on its ‘no work’ ECB 
(in its PIB), the large partition is posted 
and the large partition routine clears the 
SPIL addresses in the other large partition 
PIBs. When a large partition is posted, or 
all applicable TCBs are checked, 
interruptions are enabled. 


If no SPIL pointers were stored during 
the search, a DEQ macro instruction is 
issued (to allow other small partitions to 
make requests), and a WAIT macro 
instruction is issued on a ‘dormant’ ECB in 
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Scheduling a System Task in a Small Partition 


the small partition's PIB. (When later 
posted by the command processing routines, 
the small partition module will repeat its 
search). If at least one SPIL pointer was 
stored, a WAIT macro instruction is issued 
on ECBB in the SPIL. This allows a large 
partition, immediately upon recognition of 
the request, to post the ECB complete. The 
small partition module may then issue a DEQ 
macro instruction to release the SPIL 
pointer field so other small partitions may 
make requests. 


Next, a WAIT macro instruction is issued 
on ECBA (in the SPIL) to delay the small 
partition until the requested service has 
been performed. When ECBA is posted 
complete by the large partition, the 
completion code is tested to determine the 
action which occurred. If the completion 
code is two, job termination occurred and 
return is made to the point of determining 
the DEFINE status of the small partition. 
If the completion code is one, ‘no work' 
was found for the small partition anda 
return is made to WAIT on the ECB list in 
the SPIL. If the completion code is zero, 








the large partition is at the point of 
calling either the problem program or a 
system task. The large partition is 
waiting on ECBC (in the SPIL) to allow 
transfer of information into the small 
partition by the small partition module. 


If a problem program is to be initiated, 
IEFSD599 uses the allocate parameter list 
(APL) to move the TIOT and user parameter 
area into the small partition. It then 
posts ECBC (freeing the large partition), 
and opens Fetch and/or JOBLIB DCBs if 
required. To process write-to-programmer 
messages during problem program execution, 
IEFSD599 puts the address of the SYSOUT 
QMPA into the WTPCB, which is located in 
the CSCsB. 


The routine then determines if job step 
timing will be performed by testing the 
step time limit in the timer work area of 
the LOT biock. If this value is equal to 
24 hours, the job step will not be timed. 
If the job step is to be timed, IEFSD599 
issues the STIMER macro instruction to set 
up the step time interval. The routine 
then sets bit zero of the job step timing 
status bits field of the PIB to one 
indicate that the job step TCE is being 
used by the Initiator. It also sets bit 
one to one to indicate to step deletion 
routine IEFSDS15 that the STIMER macro 
instruction was issued specifying the TQE 
addressed in the PIB. 


The small partition routine establishes 
the partition in the problem program 
protection mode and frees the SPIL. 
program to be initiated is the DSDR 
processing step of a checkpoint restart, 
IEFSD599 uses the APL to move the TIOT and 
user parameter area into the small 
partition, and posts ECBC. The routine 
moves the job QMPA and the SYSOUT QMPA from 
the LOT to the CSCB, and bypasses opening 
the JOBLIB and FETCH DCBs. The routine 
also bypasses setting the storage 
protection key but frees the SPIL. 


If the 


A check is made to determine if the job 
has been canceled. If so, an ABEND macro 
instruction is issued. If the job has not 
been canceled, an XCTL macro instruction is 
issued to call the problem program into the 
small partition (the problem program passes 
control to ABEND at completion of its 
execution). 


ABEND recalls the small partition 
routine and enters at special entry point 
SMALLGO. The routine changes the small 
partition protection key to zero. If job 
step timing is being performed, it issues 
the TTIMER macro instruction to stop the 
timing and to obtain the step time 
remaining for use in updating the SPIL. It 
sets bit zero of the job step timing status 


bits field in the PIB to zero to indicate 
that the job step TQE is no longer active. 
After it it creates the SPIL, the routine 
updates it with the step time remaining and 
turns on the status bit indicating that 
termination services are requested. 
IEFSD599 then begins the search for a large 
partition to service the request. 


INIiITIATOR/TERMINATOR CONTROL FLOW 


There are no terminator routines that are 
unique to MFT; the modules used in MFT task 
termination are described in the MVT Job 


Management PLM. 


In addition to IEFSD510 and IEFSD599, 
several other initiator routines are unique 
to MFT. These are described in the 
following paragraphs. Descriptions of the 
MVT allocation and step initiation routines 
that have not been modified by MFT can be 


found in the MVT Job Management PLM. 


Problem Program Initialization Routine 
(LEFPPGM) 


Problem program initialization routine 
IEFPPGM receives control from system task 
control linkage routine IEFSD589 for START 
commands issued for problem programs. It 
Obtains main storage for a LOT block, if 
one does not exist, and initializes it. It 
also reinitializes fields in the CSCB, the 
PIB, and, for small partitions, the SPIL. 


The routine then tests the CHSPA field 
of the CSCB to determine if any internal 
JCL or I/O errors occurred during 
reader/interpreter processing. If either 
of these types of errors occurred, the 
problem program initialization routine 
cancels the starting task and issues an 
appropriate message to the operator. 


IEFPPGM then makes a threshold check to 
determine if enough logical tracks are 
available on SYS1.SYSJOBQOE to start an 
initiator. If not, it cancels the job and 
issues a message to the operator indicating 
this action. 


Finally, the problem program 
initialization routine passes control to 
job initiation routine IEFSD511 via an XCTL 
macro instruction. 


Job Initiation Routine (IEFSD511) 


Job initiation routine IEFSD511 issues a 
GETMAIN specifying subpool 0 to obtain 
space for the system output class directory 
(SCD). The SCD is then read into the area 
and the contents of the SCD are used to 
initialize QMGR2 in the LOT block. (QMGR2 
is the queue manager parameter area which 
is used for referencing the output data 
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set.) After OMGR2 has been initialized, 
the storage obtained for the SCD is freed. 
A GETMAIN is then issued to obtain storage 
for IOBZ, the IOB used in conjunction with 
QMGRZ. A GETMAIN is issued (specifying 
subpool 253) to obtain space for the step 
control table (SCT). The SCT is read into 
the area thus obtained. Job initiation 
then branches to data set integrity routine 
IEFSD541. 


If direct system output (DSO) processing 
is available in the partition, job 
initiation uses the SCD to build a table of 
all classes of SYSOUT, including the 
message class, contained in the job stream. 
Job initiation uses this table to determine 
if DSO is available for the job; if so, it 
selects DSOCBs for the job. Selection of a 
DSOCB is indicated by placing the problem 
program's protection key into the DSOCB and 
flagging the job's JCT. 


Data Set Integrity Routine (TEFSD541) 


The data set integrity routine is entered 
only once per job, from job initiation 
routine IEFSD511. It first determines 
whether data set integrity processing is 
required. 


If the JCT indicates a 'failed'" job or 
if there are no explicit data sets (DSNAME 
parameter ina DD statement) for the job, 
processing is bypassed and exit is made to 
step initiation routine IEFSD512. If data 
set integrity processing is required, the 
DSENQ table records are read from the job's 
entry in the input job queue 
(SYS1.SYSJOBQE). Duplicate DSNAMEsS are 
eliminated from the table and each unique 
DSNAME is placed in a minor name list. The 
most restrictive attribute (exclusive or 
share) is chosen for each DSNAME placed in 
the minor name list. After this processing 
is complete, an ENQ supervisor list is 
constructed which contains an entry for 
each DSNAME in the minor name list. Each 
entry is initialized with the following: 


e RET=TEST option of ENO. 

e SYSTEM option of ENQ. 

e Attribute (E/S) of the corresponding 
DSNAME. 

e Address of the common. major name 
"SYSDSN'. 

e Address of the corresponding DSNAME 
(considered the minor name) in the 
minor name list. 


The DSNAME (minor name) length is contained 
in the first byte of each DSNAME field in 
the minor name list. 


When the END supervisor list is 
constructed, the system is disabled and an 
ENQ supervisor call is issued against the 
list to test the availability of the 
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DSNAMES. If the DSNAMES are available, the 
ENQ supervisor list is updated so that each 
entry reflects the RET=NONE option of ENO. 
A second ENO supervisor call is issued 
against the list to reserve DSNAMEs for the 
job. The system is enabled and exit is 
Made to step initiation routine IEFSD512. 


If the DSNAMEsS are unavailable for the 
job (already reserved with conflicting 
attributes by other task(s) in the system), 
the operator is notified of the condition. 
In notifying the operator, the return code 
field of each entry in the ENO supervisor 
list is tested for a nonzero setting. If 
the setting is nonzero, the associated 
DSNAME (minor name) is identified to the 
operator as unavailable. The operator is 
given the following reply options: 


e RETRY, in case the resources have been 
freed by the other task(s) (processing 
is delayed until the operator replies). 

e CANCEL the job. 


If RETRY is entered by the operator, 
processing continues at the initial ENy 
supervisor call to again test the 
availability of the DSNAMEs. The operator 
is again notified, and he can reply either 
RETRY or CANCEL. If the job is canceled by 
the operator, the ‘job fail' bit in the JCT 
is set and exit is made to step initiation 
routine IEFSD512. 


Step Initiation Routine (IEFSD512) 


Step initiation routine IEFSD512 first 
issues a GETMAIN macro instruction to 
obtain storage for a 72-byte register save 
area for SMF user initiation exit routine 
IEFSMFIE and branches to IEFSMFIE. Upon 
return, it frees the register save area and 
tests to determine if job step timing will 
be performed. If the job time limit in the 
JCT is equal to 24 hours, the job step will 
not be timed. In this case the step 
initiation routine moves the 24 hour limit 
to the timer work area in the 1life-of-task 
(LOT) block, and bypasses the procedure for 
setting up the step time limit. 


If the job time limit in the JCT is 
equal to any value other than 24 hours, 
IEFSD512 determines the value to be used as 
the step time limit in the timer work area 
of the LOT block. For each step of the 
job, the routine determines if allowing the 
step to use the full amount of time 
specified for it would cause the job time 
limit to be exceeded: IEFSD512 calculates 
the amount of job time remaining by 
subtracting the job time used from the job 
time limit and compares this figure with 
the step time limit. It establishes the 
step time limit by placing the smaller of 
the two figures in the step time limit 
field of the timer work area. If the 








smaller of the two figures is the job time 
remaining, the routine turns on the high 
order bit in the step time remaining field 
of the timer work area to indicate that the 
job time remaining is being used as the 
step time limit. 


IEFSD512 then issues a GETMAIN 
specifying subpool 253 to obtain storage 
for an allocate register save area (ARSA) 
and an allocate parameter list (APL). The 
APL (Figure 6) is initialized containing 
addresses of the LOT, JCT, and SCT, and two 
words of zeros. 


Address of the LCT 


Address of the JCT 


Address of the SCT 


Address of the TIOT List 
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Allocate/Terminate Parameter 
List 


Figure 6. 


The step initiation routine checks the 
current step to determine if it is either 
the checkpoint/restart data set descriptor 
record (DSDR) processing step or the 
restart step. If the step is a DSDR 
processing step being scheduled for a small 
partition containing less than 12K bytes, 
the PIB of the partition containing the 
step initiation routine will be tagged to 
indicate that the DSDR step is to execute 
in that partition. MThe step initiation 
routine will place the address of its TCB 
and PIB in the LOT and pass control to 
allocation via an XCTL macro instruction. 
If the DSDR step is to be processed ina 
large partition, normal processing is 
continued. 


If the step is the restart step, the 
step initiation routine will pass control 
to partition recovery routine IEFSD518 via 
a LINK macro instruction. If the return 
code from IEFSD518 is a zero, normal 
processing is continued; if the return code 
from IEFSD518 is a four, the address of the 
LOT is placed in register 1 and control is 
passed to job selection IEFSD510 via an 
XCIL macro instruction. 


If the job is using DSO, a message to 
that effect is placed in the first SMB. 
Step initiation then passes control to 
Allocation via an XCTL macro instruction. 
Allocation returns to IEFSD512 at entry 
point IEFALRET via an XCTL macro 
instruction and returns the addresses of a 
task input/output table (TIOT) list (which 
points to the TIOT) in the first word of 
zeros in the APL... On return from 
Allocation, the return code is tested to 
determine if allocation was successful. If 
not, step initiation moves the TIOT to 
subpool 253 and passes control to alternate 
step deletion routine IEFSD516 via an XCTL 
Macro instruction. 


If allocation was successful, the TIOT 
is moved to subpool zeor, the ARSA is 
freed, and the “step started" bit in the 
SCT is turned on. The address of the job's 
CSCB is stored in the APL (in the last word 
of the list). If the job is using DSO, and 
if job separator and/or system message 
processing is required, step initiation 
links to system message and job separator 
writer routine IEFDSOWR. If IEFDSOWR is 
unable to process due to a job queue I/0 
error, the initiator will ABEND with an 
error code of OBO; if IEFDSOWR is unable to 
process due to I/O errors, step initiation 
will set the job failed bit. 


The step initiation routine then frees 
the ARSA and updates the LCT with the TTR 
of the JCT and the TTR of the SCT. it 
scans the program properties table 
(LEFSDPPT) to determine if the program to 
be executed is to be non-cancellable during 
its execution. If so, it turns off the 
cancellable bit in the CSCB. IEFSD512 then 
uses table breakup routine IEFSD514 to 
write the TIOT and the LCT on the job 
queue. Upon return from IEFSD514, the step 
initiation routine updates the JCT with the 
TTR of the TIOT. It then uses the queue 
Manager to write the JCT and the SCT back 
on the job queue, and to read the user 
parameters into main storage. Finally, it 
tests to determine if the step is a DSDR 
processing step and if not, IEFSD512 frees 
the ECB/IOBs used by the queue manager. It 
then passes control to problem program 
interface routine IEFSD513. 


Note: For a description of the program 
properties table, see the MVT Job 


Management PLM. 
SMF User Initiation Exit Routine (IEFSMFIE) 





SMF user initiation exit routine IEFSMFIE 
receives control from step initiation 
routine IEFSD512. It first determines if 
SMF is supported by testing the JCTJMROP 
field of the JCT for a zero value. A zero 
value indicates that SMF is not supported. 
In this case the routine immediately 
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returns control to the caller (IEFSD5i2). 
If SMF is supported, the SMF user 
initiation exit routine performs the 
following functions: 


e It initializes and updates the timing 
control table (TCT). 

e It updates the job log portion of the 
job management record (JMR). 

e It passes control to the user's job 
initiation exit routine, IEFUJI, or 
step initiation exit routine, IEFUSI. 

e It constructs the SMF Job Commencement 
Record (type 20). | 


When it is entered, IEFSMFIE issues the 
TIME BIN macro instruction and stores the 
job initiation start time and date in the 
JCT. It then determines if the step being 
initated is the first step of the job. If 
so, it issues a GETMAIN macro instruction 
specifying the system queue area to obtain 
Main storage for the TCT and for the first 
40 bytes of the JMR. The routine 
initializes the TCT and stores its address 
in the TCBTCT field of the TCB. It then 
uses the Queue Management Read/Write 
routine to bring the JMR into main storage. 
It copies the first 40 bytes of the JMR 
into the area reserved for it and updates 
it with the job initiation start time and 
date. If user exits are specified, the 
routine brings the job account control 
table (ACT) into main storage and then 
passes control to user job initiation exit 
routine IEFUJI. 


If the step being initated is not the 
first step of the job, the TCT and JMR are 
already in main storage. IEFSMFIE stores 
the step initiation start time and date in 
the JMR. If user exits are specified, the 
routine brings the job ACT into main 
storage and then passes control to user 

step initiation routine IEFUSI. 


Upon return from the user exit routine, 
IEFSMFIE inspects the return code. If the 
return code specifies that the job is to be 
canceled, the routine sets the job-failed 
bit in the JCT. 


For each job, the SMF user initiation 
exit routine also determines if the data 
set accounting option is specified by 
testing the SMCAOPT field in the SMCA. If 
the option is not specified, or if the job 
was cancelied, the routine bypasses 
construction of a Job Commencement Record 
(type 20). Otherwise, IEFSMFIE builds the 
record using the accounting information in 
the job ACT and issues an SVC 83 to have 
the record transferred to the SMF buffer. 


When processing is complete, IEFSMFIE 
returns control to the caller (IEFSD512). 
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Note: For the format and description of 


the JMR and TCT, see "Appendix A" in the 


MVI Job Management PLM. 


Problem Program Interface Routine 
(ITEFSD513) 


The problem program interface routine 
prepares the partition for execution of the 
job step. It first passes control to SMF 
TCTIOT construction routine IEFSMFAT. Upon 
return the routine determines if SMF is 
Supported by testing register 15. A zero 
value indicates that SMF is not supported 
and in this case IEFSD513 bypasses the 
procedures for updating the TCT with the 
job wait time limit. 


If SMF is supported, register 15 
contains the address of the TCT and 
register 0 contains the job wait time limit 
obtained from the system management control 
area (SMCA) by IEFSMFAT. In this case 
ITEFSD513 places the job wait time limit in 
the TCTWLMT field of the TCT. It also 
initializes bit zero of the TCTSW field to 
correspond with the bit set in the time 
remaining field of the timer work area by 
IEFSD512 indicating whether the job time 


remaining or the step time limit was 


established as the time limit for the step 
about to receive control. 


The problem program interface routine 
then tests to determine if scheduling was 
performed for a small partition. If so, 
this routine tests its partition's PIB to 
determine whether a checkpoint/restart data 
set descriptor record (DSDR) is to be 
processed. If the DSDR step is to be 
processed, the SPIL pointer in the LOT is 
ignored; otherwise the address of the APL 
is placed in the SPIL, ECBA in the SPIL is 
posted to indicate that scheduling is 
complete, and a WAIT is issued on ECBC. 
This WAIT allows the small partition module 
to copy tables and work areas into the 
small partition. When the tables have been 
copied, ECBC is posted complete, and the 
interface routine frees all storage 
obtained for tables and work areas except 
for the LOT block, which is retained. The 
address of the LOT block is placed in 
register 1 and this routine passes control 
to job selection, IEFSD510, via an XCTL 
macro instruction. 


If scheduling was not performed for a 
small partition, a test is made to 
determine if the job has been canceled. If 
SO, exit is made by issuing an ABEND macro 
instruction. 


If the job has not been canceled, the 
job OMPA and the SYSOUT QMPA are moved from 
the LOT to the CSCB, the TIOT is moved to 
the lowest possible location (subpool 0) in 
the partition, and a GETMAIN macro 








instruction specifying subpool 253 is 
issued for the user's parameter list (UPL). 
The UPL (Figure 7) is initialized from the 
SCT. Another GETMAIN macro instruction 
(subpool 253) is issued to create a 
register Save area for the user's problem 
program. If STEPLIB, JOBLIB, and/or FETCH 
have been specified, their DCBs are created 
(but not opened) in subpool 253. The JCT, 
SCT, and APL are now freed, the STEPLIB or 
JOBLIB and FETCH DCBs are opened, and the 
TIOT is then moved to subpool 253. A 
Single DCB is used for STEPLIB or JOBLIB, 
with STEPLIB overriding JOBLIB if both are 
present. 


ae) 
Address of length field 
2 
Length of PARM values 


PARM values 
(from EXEC statement) 














(Maximum length = 100 bytes) 


User's Parameter List 


Figure 7. 


If the job being started in the 
partition is a checkpoint/restart data set 
descriptor record (DSDR) processing job, 
the routine bypasses opening the STEPLIB, 
JOBLIB, and FETCH DCBs and also bypasses 
setting the storage protection key. 


Note: The use of subpools, and the order 
in which control blocks and tables are 
created, moved, or deleted, follows a 
particular sequence even though this 
handling occurs within different modules. 
This is done to prevent fragmenting main 
storage within the partition. 


The routine then sets the PSW to the 
problem program mode. IEFSD513 then tests 
to determine if job step timing will be 
performed. If the step time limit in the 
timer work area of the LOT block is equal 
to 24 hours, the job step will not be 
timed. If the step time limit is equal to 
any value other than a 24 hours, the 
problem program interface routine issues 
the STIMER macro instruction to set up the 
step time interval. It then sets bit zero 
of the job step timing status bits field in 
the PIB to one to indicate that the job 
step TOE is being used by the Initiator. 
It also sets bit one to one to indicate to 


step deletion routine IEFSDS1i5 that the 
STIMER macro instruction was issued 
specifying the TQE addressed in the PIB. 


Whether or not job step timing is 
performed, IEFSD513 frees main storage for 
the LOT block, moves the TIOT to the 
highest available position within the 
partition, updates the TCB, and passes 
control to the problem program via an XCTL 
macro instruction. 


SMF TCTIOT Construction Routine (IEFSMFAT) 


If SMF is in the system and if the user 
accounting option is specified, the SMF 
TCTIOT construction routine IEFSMFAT builds 
and initializes a timing control task 
input/output table (TCTICT). The routine 
first determines if SMF is supported by 
testing the TCBTCT field of the TCB for a 
zero value. A zero value indicates that 
SMF is not supported. In this case the 
routine places a return code of zero in 
register 15 and returns control to the 
caller (IEFSD513). 


If SMF is in the system, the TCBTCT 
field contains the address of a TCT built 
by SMF user initiation exit routine 
IEFSMFIE. In this case the routine obtains 
the job wait time limit from the system 
Management control area (SMCA) for return 
in register 0 to IEFSD513 for updating the 
TCT. If user exits are specified, IEFSMFAT 
places the address of SMF user time limit 
expiration routine IEFUTL in the TCT. 


The routine next determines if the user 
step option is specified by testing the 
SMCA options field for a X'40'. For any 
other value the option is not specified and 
the TCTIOT construction is bypassed. If 
the user step option is specified, IEFSMFAT 
constructs a TCTIOT to contain the 
information necessary for the SMF 
termination record. The routine issues a 
GETMAIN macro instruction specifying the 
system queue area to obtain storage for the 
TCTIOT and initializes the TCT EXCP counter 
lookup table. 


Whether or not the routine constructed a 
TCTIOT, it initializes the TCT core map for 
both hierarchies (0 and 1). It utilizes 
the boundary box describing the partition 
to determine the lowest addresses allocated 
at the high end of hierarchies 0 and 1, and 
the highest addresses allocated at the low 
end of hierarchies 0 and 1. It then 
calculates the amount of storage unused and 
stores these figures in the TCT. 


IEFSMFAT issues a TIME macro instruction 
to obtain a time stamp to indicate the time 
the problem program started loading. fThe 
time stamp is stored in the TCT. 
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Finally, IEFSMFAT places the TCT address 
in register 15 and returns control to the 
caller (IEFSD513). 


Note: For the format and description of 
the SMCA and the TCTIOT, see “Appendix A" 
in the MVT Job Management PLM. 





Step Deletion Routine (IEFSD515) 
Step deletion routine IEFSD515 is entered 
at the end of step execution to prepare the 
partition for continued execution of the 
job, to interface with the termination 
subroutine, to prepare for the initiation 
of the next step, or to branch to job 
deletion if there are no more steps in the 
current job. 


When step deletion is entered, a check 
is made to determine whether the routine 
was entered due to an ABEND with the 
scheduler in control. If so, a message 
stating that the scheduler has ABENDed is 
issued to the operator and ail CSCBs are 
removed from the CSCB chain. DSO 
processing, if any, in the partition is 
marked for stopping. Control passes to job 
selection routine IEFSD510 which passes 
control to DSO stop and modify command 
processing routine IEFDSOSM. 


If the scheduler ABENDsS again while 
trying to stop DSO, the DSOCB will be 
marked as being no longer available for 
selection. The DSOCB I/O device will 
remain allocated to DSO, and the device 
will not be available until the system is 
reinitialized. 


If an ABEND did not occur, the step 
deletion routine prepares to calculate the 
amount of time used by the step and the job 
when the last step completed execution. It 
determines if job step timing is being 
performed by testing the high-order bit in 
the job step timing status bits field of 
the PIB. If the bit is off, the following 
processing is bypassed. If it is on, the 
TOE is being used for job step timing and 
IEFSD515 issues a TTIMER macro instruction 
to stop the timing started by problem 
program interface routine IEFSD513. It 
also obtains the step time remaining for 
use in updating the timer work area when 
the LOT block is read back in. It then 
turns off the high-order bit in the job 
step timing status bits field of the PIB. 


Whether or not job step timing is beiiug 
performed, the step deletion routine 
branches to ENQ/DEQ purge routine IEFSD598 
via a BALR instruction to remove any 
control blocks which were enqueued, but not 
dequeued, by the problem program step. 


Step deletion then issues a series of 
GETMAIN requests to obtain storage for 
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queue manager IOBs (IOB1 and IOB2), a 
temporary QMPA, and a register save area 
and parameter list for the table breakup 
routine. These blocks and tables are 
initialized and step deletion branches to 
queue manager table breakup routine 
IEFSD514, to read in the TIOT and LOT 
blocks for the job step. 


IEFSD515 updates the step time remaining 
field of the timer work area in the LOT 
block with the step time remaining value 
obtained from the TTIMER macro instruction. 
It restores the addresses in the TIOT and 
LOT blocks, and frees the temporary work 
areas. 


It returns the job QMPA and the SYSOUT 
QMPA to the LOT block from the CSCB to 
reflect any activity that occurred during 
problem program execution. 


A GETMAIN (subpool 253) is issued to 
obtain storage for the SCT and JCT. The 
SCT is read into storage from the job 
queue, the JCT from its temporary area. 
The JCT is updated with the address of the 
next SCT and written back on the job queue. 


A test is made to determine if job step 
timing is being performed. If the step 
time limit in the timer work area is equal 
to 24 hours and if bit one of the job step 
timing status bits field in the PIB is set 
to zero, neither the job nor the step has 
been timed and the routine bypasses the 
following processing and obtains storage 
for the terminate register save area and 
parameter list. If the step has been 
timed, the values in the timer work area 
must be updated to reflect the time used by 
the step that just completed execution. If 
SMF is supported (determined by a nonzero 
value in the TCBICT field of the TCB), the 
time extension specified is calculated and 
added to the step time limit. 


The information in the timer work area 
is then used to calculate the new values 
for job time used, job time remaining, step 
time used, and step time remaining, and the 
timer work area is updated with these | 
calculations. 


The Queue Management Read/Write routine 
is used to read in the job and step ACTs. 
They are updated with the new values for 
the job and step time, and then written 
back out. 


Storage is obtained for a terminate 
register save area and a terminate 
parameter list. The terminate parameter 
list is initialized with addresses of 
control blocks (LOT, JCT, SCT, and TIOT 
list) and the step deletion routine 
branches to the termination subroutine via 
a BALR instruction. When termination 
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returns control, step deletion frees the 
terminate register save area and terminate 
parameter list and then reinitializes the 
WIPCB for the next step of the job or the 
next job. If the partition was executing 
the DSDR step for a small partition, step 
deletion places the addresses of the small 
partition's TCB and PIB into the LOT block. 
Step deletion then checks the return code 
from termination. 


If the return code indicates that the 
job is to be suspended, step deletion loads 
the address of the LOT block in register 1. 
In MFT systems with the 44K scheduler, step 
deletion then passes control to IEFSD168 
Via a BALR instruction. In MFT systems 
with a 30K scheduler, however, step 
deletion branches to linkage routine 
IEFSD167 to pass control to IEFSD168 via an 
XCTL macro instruction. If the return code 
indicates that job termination was entered, 
step deletion branches to job deletion 
routine IEFSD517 and, in MFT systems with 
the 44K scheduler, receives control again. 
In MFT systems with the 30K scheduler, 
however, control does not return to step 
deletion. It is passed immediately to 
IEFSD517. If job termination was not 
entered, the SCT for the next step of the 
job is read from the job queue, and step 
deletion passes control to IEFSD512 via an 
XCTL macro instruction. 


Note: If a small partition is requesting 
termination, entry to the step deletion 
routine is made at special entry point 
SMALTERM. When the routine is entered at 
this point, it performs the following 
functions before invoking ENQ/DEQ purge 
routine IEFSD598. It obtains the step time 
remaining for the step which executed in 
the small partition from the SPIL and saves 
this value for updating the step time 
remaining field of the timer work area in 
the LOT block, when the block is read back 
in. IEFSD515 also establishes pointers to 
the SPIL and the small partition"'s TCB. 


ENO/DEQ Purge Routine (IEFSD598) 


At job termination, this routine purges all 
ENO/DEQ control blocks associated with the 
TCB address passed in Register 4 by the 
caller. If step termination was completed 
instead, this routine purges all ENQ/DEQ 
control blocks except the data set 
integrity blocks associated with the major 
name SYSDSN. 


When a given resource is dequeued for 
the subject TCB, a task switch may occur 
for a higher priority requestor whose wait 
count becomes zero, due to availability of 
the resource. (This purge routine operates 
in a disabled state to prevent concurrent 
updating of the ENQ/DEQ control blocks.) 


Alternate Step Deletion Routine (IEFSD516) 


Alternate step deletion routine IEFSD516 is 
entered from step initiation routine 
IEFSD512 when allocation for a step has not 
been successful. Using the APL and ARSA 
(created by the step initiation routine) as 
the terminate parameter list and terminate 
register save area, this routine branches 
to termination subroutine IEFSD22Q via a 
BALR macro instruction. When control is 
returned from termination, the storage used 
for the parameter list and register save 
area is freed and a test is made to 
determine if job termination was entered. 
If so, this routine branches to job 
deletion routine IEFSD517. If job 
termination was not entered, the SCT for 
the next job step is read from the job 
queue and this routine branches to step 
initiation routine IEFSD512. 


Job Deletion Routine (IEFSD517) 


The job deletion routine is called at job 
termination to delete the job from the 
input queue and to prepare the partition 
for initiation of the next job. The 
routine sets the high-order byte of the 
LCTTCBAD field of the LCT to ‘80° 
(hexadecimal) to indicate to the ENQ/DEQ 
purge routine that it is job termination 
instead of step termination. The routine 
then branches to ENQ/DEQ purge routine 
IEFSD598 to purge the control blocks. On 
return from the purge routine, the 
high-order byte is reset to '00'. 


The job deletion routine then deletes 
the job from the input queue, using queue 
Manager delete routine IEFQDELQO. All areas 
of storage in the partition which were used 
for the job (except the LOT block) are 
freed, and the job's CSCB is freed by 
issuing an SVC 34. The PIB fields used for 
the disk address of the TIOT and the LOT 
block are set to zero. If termination was 
for a small partition, ECBA in the SPIL is 
posted with a code of two (indicating job 
termination for the small partition). If 
termination was for a large partition (or 
after ECBA has been posted) the "no work" 
ECB in. the PIB is posted and the job 
deletion routine branches to job selection 
routine IEFSD510. 


Partition Recovery Routine (IEFSD518) 


Partition recovery routine IEFSD518 
determines the location of main storage 
required for a checkpoint restart. If the 
partition being scheduled for the job to be 
restarted contains the required main 
storage, the JCT is checked to determine if 
the job used DSO. If it did, the jop‘s 
SIOTs are checked to determine which types 
of I/O devices were used. If any needed 
type is not available, a message informing 
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the operator of the missing devices is sent 
and the job is placed on the hold queue. 
If all devices are available, the routine 
returns to the step initiation routine for 
normal processing. If the nucleus has 
expanded past the lower boundary of the 
partition containing the required main 
storage, the routine sets the job fail bit 
in the JCT, issues a message stating that 
Main storage is not available for the job, 
and returns to the step initiation routine 
ITEFSD512 with a return code of zero. 


If the partition being scheduled does 
not contain the required main storage, the 
routine places the job on the hold queue, 
updates the SCD and places the SCD back on 
the job queue. The job's CSCB is unchained 
and the space containing the CSCB and the 
ECB/IOBs is freed. If the job used DSO, 
the routine links to release DSOCB routine 
IEFDSOFB to release any DSO processor 
allocated to the job. The routine then 
branches to ENQ/DEQ purge routine IEFSD598. 


Upon return from ENQ/DEQ purge routine, 
if a problem program partition exists that 
contains the required main storage, this 
routine will create an internal queue 
element and chain it to the partition's 
PIB. The partition's "no work" ECB will be 
posted and a message will be issued stating 
that the job will start in the partition. 
If an existing partition contains the 
required main storage and is defined as a 
reader or writer partition, this routine 
issues a message indicating that the 
partition must be redefined to accept the 
desired jobclass. If no partition contains 
the required.main storage or the partition 
that contains the required main storage is 
about to be redefined, this routine issues 
a message stating the length and 
displacement of the required main storage. 
If the partition being scheduled was a 
large partition its no-work ECB is posted; 
if it was a small partition, the SPIL is 
posted indicating job termination. The 
partition recovery routine frees the JCT 
and SCT areas of the partition and returns 
control to step initiation routine IEFSD512 
with a return code of four. 


Dequeue by Jobname Interface Routine 
(ITEFSD519) 


Dequeue by jobname interface routine 
(IEFSD519) builds a parameter list used by 
dequeue by jobname routine IEFLOCDQ to 
locate a job named on the 
checkpoint/restart internal job queue. 
When a checkpoint/restart job is indicated 
by an entry in the internal job queue 
pointer in the PIB being processed by job 
selection routine IEFSD510, job selection 
branches to IEFSD519 which builds the 
seven-word parameter list required by 
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IEFLOCDQ. When the job is dequeued, 
IEFLOCDQ returns control to IEFSD519. jf 
The interface routine marks the job as Na ait 


ready and returns to job selection with a 
code of zero in register 15, indicating 
that the job has been found, and a pointer 
to the LOT in register 1. If the job is 
not found by IEFLOCDQ, a return code of 
four is returned in register 15 to job 
selection. (For a description of IEFLOCDQ 


see the MVT_ Job Management PLM.) | F 


System Output Writers 


MFT uses the MVT system output writer 
(Charts 15-16) with minor changes to five 
of the modules. As in MVT, the user may 
have up to 36 system output writers 
operating concurrently in the system. 
output writer can handle eight output 
classes; output classes may be shared py 
writers. However, in MFT, system output 
writers are classified as either resident 
or nonresident. A resident writer operates 
in its own partition. A nonresident writer 
Operates in any problem program partition 
large enough to accommodate it. 


Each 


RESIDENT WRITERS 


Resident output writer partitions are Mahe 
designated in the TCB by a setting of '10' 

in the first two bits of the pointer to the 
partition information block (PIB). This 
designation is made at system generation by 
assigning W to the partition in place of 

the job class or by redefining a partition 

and assigning WTR to it. 


A resident writer is activated by 
issuing a START command specifying a 
partition designated previously as a writer 
partition. A resident writer can be 
terminated only by issuing a STOP command 
specifying the device assigned to that 
writer. 


NONRESIDENT WRITERS : 


A nonresident system output writer may be 
Started ina problem program partition 
large enough to hold the writer by issuing 
a START command specifying either that 
partition or by replacing the partition 
number with an 'S' to specify a 
system-assigned nonresident writer. 


When the writer has started, it executes © 
in the same way aS a resident writer and _ 
must be terminated by a STOP command to —_ 
allow processing of problem programs to be Me 
resumed in the partition. ~ 








SYSTEM OUTPUT WRITER MODULES 


the following five MVT system output writer 
modules are modified for MFT. 


e ITEFSDO70 - Data Set Writer Linkage 
Routine. 

e TEFSD079 - Linkage to Queue Manager 
Delete Routine. 

e ITEFSDO84 - Wait Routine. 

e ITEFSDO85 - Data Set Block (DSB) Handler 


Routine. 


IEFSDO087 = Standard Writer Routine. 


Descriptions of all other system output 
writer modules can be found in the MVYT Job 
Management PLM. 


Data Set Writer Linkage Routine (IEFSD070) 


This routine passes control to the 
appropriate writer routine via a LINK macro 
instruction. The normal linkage is to the 
Standard writer, IEFSD087. If a special 
user-written output writer routine is 
requested, this routine passes control to 
that writer. Upon return from either 
writer, the routine passes control to data 
set delete routine IEFSD171 via an XCTL 
Macro instruction which deletes the output 
data sets from the output queue. 


Linkage to Queue Manager Delete Routine 
(ITEFSD079) 





Upon completion of a job, linkage module 
IEFSD079 passes control to queue manager 
delete routine IEFQDELO via an XCTL macro 
instruction to delete all control blocks 
and SMBs associated with the output job 
from the job queue. Following deletion, 
the routine then posts all reader ECBs that 
are waiting for space to indicate that 
space iS now available. (The reader ECB 
chain address is obtained from the master 
scheduler resident data area.) When all 
ECBs have been posted, control is returned 
to main logic routine IEFSD082. 


Wait Routine (IEFSD084) 


This routine serves as a multiple WAIT when 
there is no work in any of the output 
classes associated with the writer. It 
issues a WAIT macro instruction on the ECB 
list created by class name setup routine 
IEFSD081. When the system output writer 
enters a wait state, the wait routine 
issues a message informing the operator 
that the writer is waiting for work. Any 
posting (such as a command, or work for the 
writer) causes control to be given to 
IEFSD082. 


DSB Handler Routine (IBFSDO085) 


DSB handler routine IEFSD085 is the setup 
module for printing data sets. It issues a 
GETMAIN macro instruction for the input DCB 
if it was not obit.ained before, and 
constructs a new (IOT containing an entry 
for the input data set. It also sets up 
any user-written output writer program. A 
check is then made to determine if a pause 
is required between data sets or only at 
forms change. If a special form is to be 
used, the routine writes a message to the 
operator telling him what form to put in 
the output device. The form change only 
occurs if the output device is unit record. 
This routine then passes control to linkage 
routine ITEFSD070 via an XCTL macro 
instruction. 


Standard Writer Routine (IEFSDO087) 


This routine first issues an OPEN macro 
instruction to open the output data set. 
If the data set was not opened by the 
problem program, no attempt is made to 
process the data set. After OPEN, a test 
is made to check for machine control 
characters. A switch is set that is 
interrogated by PUT routine IEFSD089. The 
writer then passes control to transition 
routine IEFSD088 which creates header and 
trailer records. Upon return from 
IEFSDO88, the writer routine checks the 
CANCEL ECB in the CSCB to determine if a 
CANCEL command has been issued for this 
writer. If the CANCEL ECB has been posted 
complete, control passes to transition 
routine IEFSD088 to create a trailer 
record. When control is returned from 
IEFSD088, the writer is closed. Control is 
then returned to linkage routine IEFSD078 
Via a RETURN macro instruction. 


If the writer is not to be canceled, the 
writer routine issues a GET macro 
instruction to read a record and checks for 
a control character. If no control 
character exists, the writer puts one in 
which causes the printer to skip one line 
or the punch to feed into the normal 
pocket. If the printer has overflowed, a 
skip is made to the next page. 


The writer then adjusts the pointer to 
the record so that it points to the first 
data character (instead of control 
character) and passes control to transition 
routine ITEFSD088 for trailer records. It 
then issues a CLOSE macro instruction to 
close the input data set, a FREEPOOL macro 
instruction to free the buffers, and 
returns control to linkage module IEFSDO078 
via a RETURN macro instruction. 
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Direct System Output Processing 


Direct system output (DSO) processing 
Operates in MFT in the same Manner as in 
MVT. The main difference between DSO in 
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MFT and MVT is that DSO started in an MFT 
partition can only process output from jobs 
within that partition whereas DSO started 
in an MVT system is not restricted by 
partition boundary. 





Operator commands control system operation 
and modify system tasks. Command 
processing in MFT is handled by the SVC 34 
command scheduler routines, the master 
scheduler resident command processor 
routines, and the system task control 
routines. With the exception of DEFINE, 
HALT, MODE, and SWAP, commands can be 
entered into the system through the console 
or the input job stream. The DEFINE, HALT, 
MODE, and SWAP commands can be entered only 
through the console. Commands entered 
through the console are read by the 
communications task and routed to the 
master scheduler. When a command is 
encountered in the input stream, the 
reader/interpreter passes control to SVC 34 
to process the command. SVC 34 processes 
most commands completely and returns 
control to the interrupted routine. 


The commands accepted and processed by 
MFT are the following: 


CANCEL 
CONTROL 
DEFINE 
DISPLAY 
DUMP 
HALT 
HOLD 
LOG 
MODE 
MODIFY 
MONITOR 
MOUNT 
MSGRT 
RELEASE 
REPLY 
RESET 
SET 
START 
STOP 
STOPMN 
SWAP 
SWITCH 
UNLOAD 
VARY 
WRITELOG 


The format and syntax of these commands can 
be found in the Operator's Reference 
manual. 


SVC 34 processes all commands completely 
except CANCEL, DEFINE, DISPLAY (A, 
CONSOLES, jobname, N, Q, U), HOLD, LOG, 
RELEASE, RESET, START and WRITELOG. SVC 34 
does preliminary processing of these 
commands and passes control to the master 
scheduler resident command processor to 
complete the processing of all but the 
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START, WRITELOG, and LOG commands. If the 
master scheduler resident command processor 
is processing a DEFINE command, SVC 34 
queues all commands until the DEFINE 
command has been completely processed. 


When a WRITELOG command is found, SVC 34 
stores it and posts the System Log task 
ECB. (See the MFT Supervisor PLM.) When a 
START command is found, SVC 34 builds and 
chains a CSCB, places the address of the 
CSCB in the partition's PIB, and posts the 
partition. The system task control — 
routines further process the START command. 
When a LOG command is found, SVC 34 issues 
a WIL macro instruction (SVC 36) to have 
the LOG command processed in a manner 
Similar to a write-to-log macro instruction 
issued by a problem program. 


When processing commands, interruptions 
are disabled so that command processing may 
be completed before any other interruptions 
are serviced. Although commands are 
processed when issued, the command may not 
take effect immediately. An example of 
this is the STOP writer command. The 
master scheduler marks a command scheduling 
control block (CSCB) which is checked by 
the writer between jobs. The command does 
not take effect until the writer completes 
the job it was processing when the command 
was issued. 


SVC 34 Routines 


SVC 34 (Chart 6) is called to process all 
commands. As previously noted, it 
processes some of these commands completely 
and calls the resident command processor or 
system task control to process the 
remaining commands. The commands processed 
completely by SVC 34 are: 


CANCEL (active jobs only) 

CONTROL 

DISPLAY (R, SQA, T) 

HALT 

MODE 

MODIFY 

MONITOR (DSNAME, JOBNAMES, SPACE, 
STATUS) 

MOUNT 

REPLY 

STOP 

STOPMN 

SWAP 

SWITCH 

UNLOAD 

VARY 


Part 3: Command Processing 37 


The SWAP command is accepted and processed 
only if Dynamic Device Reconfiguration 
(DDR) is in the system. 


There are four SVC 34 routines that are 
unique to the MFT configuration of the 
control program. These routines include 
the DEFINE and MOUNT Commands routine 
(IEESD571), the CANCEL command routine 
(ITEE2803D), and the STOP INIT and START 
commands processing routines (IEESD561 and 
IEE3903D). These routines are described 
below. 


Other SVC 34 routines are described in 
the MVf Job Management PLM. Two major . 
differences between SVC 34 processing in 
MFT and MVI should be noted: 


e TSO commands are processed by the MV1I 
SVC 34 routines. TSO is not supported 
by the MFT configuration of the control 
program. 


e A STAE environment is established for 
the MVT SVC 34 routines, but not for 
the MFT Svc 34 routines. Therefore, in 
MVT, the first SVC 34 routine to be 
executed creates the STAE environment. 
This routine precedes chain 
manipulation routine IEE0303D, which is 
the same in both systems, and is the 
first SVC 34 routine to be executed in 
MFT. 


DEFINE and MOUNT Routine (IEESD571) 

This routine processes the DEFINE command 
by setting the necessary indicators in the 
master scheduler resident data area. It 
then posts the ECB for the master scheduler 
resident command processor IEECIR50. 


This routine processes the MOUNT command 
as that command is processed in PCP. It 
builds a parameter list for, and issues an 
XCTL macro instruction to, the PCP master 
command EXCP routine IGC0103D. 


CANCEL Command Routine (IEE2803D) 


This routine processes the CANCEL command 
by scanning the CSCBs for the job name 
given in the CANCEL command. If the job 
name is found, indicating that the job is 
active, and if the command did not have an 
IN or OUT parameter, the CSCB is checked to 
determine if it is cancelable, that is, if 
it represents a problem program. If it 
does, IEE2803D issues a BALR to ABTERM, 
passing the address of the job's TCB and 
indicating a completion code of 222 if no 
dump is to be taken, or 122 if a dump is to 
be taken. 


If the CSCB is not cancelable, that is, 


if it represents a system task, the CSCB is 
marked canceled and is posted. 
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If the job is represented on the CSCB 
chain, but the command specified IN or OUT, 
the "Job Selected" message is written to 
the operator and control is returned to the 
caller. 


If the job is not represented on the 
CSCB, indicating that the job is either in 
the input or output queue(s) or that it 
does not exist, IEFE2803D passes control via 
an XCTL macro instruction to CSCB creation 
routine ITEE0803D to build a CSCB for the 
CANCEL command. (See the MVT Job 
Management PLM for a description of 
IEEO803D.) 


STOP INIT and START Commands Processing 


Routines (IEESD561 and IEE3903D) 


These routines perform the initial 
processing for all the START commands and 
the STOP INIT command. When a START 


command is received, STOP INIT and START 


command syntax scan routine IEESD561 
examines the command parameters. If 
anything other than a system reader or 
writer is to be started, the routine 
determines the number and status of the 
partition named in the command. If the 
command is a STOP INIT command, IEESD561 
determines which partition contains the 
initiator to be stopped. The routine then 
passes control via an XCTL macro instruc- 
tion to STOP INIT and START Command Pro- 
cessor routine, IEE3903D. (See Figure 8.) 
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in Input 
Stream 


START Command 
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SVC 34 


Check 
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Task Processing and Interpreter 
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Chain CSCB 
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"Nlo Work" ECB 





Return to IOS 


Figure 8. START Command Processing Flow 








If the command is a START command, 
command processor routine IBE3903D builds 
and chains a CSCB, places the address of 
the CSCB in the partition's PIB, and posts 
the partition. If a system reader is to be 
started, the routine searches for a 
scheduler-size problem program partition 
which is inactive; if a system writer is to 
be started, the routine searches for any 
inactive problem program partition. Ifa 
partition is located, the routine builds 
and processes a CSCB as stated above. Ifa 
partition cannot be found, the routine 
issues a message to the operator stating 
that the command has failed. If the 
command is a STOP INIT command, the routine 
verifies that the partition contains an 
initiator and sets the STOP INI? indicator 
in the partition's Pib. 


The section "System Task Control" 
describes the further processing of the 
START command CSCB. The processing of a 
STOP INI? indicator is completed by the 
Initiator/Terminator. 


Master Scheduler Resident Command Processor 


In MFT systems, SVC 34 does preliminary 
processing for the commands CANCEL, DEFINE, 
DISPLAY (A, CONSOLES, jobname, N, PFK, 
(C,K),v U), DUMP, HOLD, MONITOR A, RELEASE 
and RESET, and passes control to the master 
scheduier resident command processor, 
IEECIR50, to complete the processing. 
IEECIR50 in turn passes control via a LINK 
macro instruction to the Command Analyzer 
routine, IEECIR51. IEECIR51 analyzes the 
command and passes control to the Queue 
Alter routine, to the DEFINE command 
processor, or returns control to IBECIR50 
for issuing of SVC 110. 


The master scheduler resiaent command 
processor resides in the nucleus and 
Operates under control of its own TCE. The 
master scheduler TCB is always dispatchable 
and is of higher priority on the TCB queue 
than the TCBs for the partitioned area (the 
problem program area) of main storage. 


The master scheduler resident command 
processor, IEECIR50O, waits on an ECB which 
is posted by SVC 34 when a command has been 
scheduled for processing. Control is then 
passed to the command analyzer routine, 
IEECIR51, whicn scans the CSCB chain for 
any commands to be processed. If a command 
is found, the CSCB is removed from the 
chain and control is passed to the 
appropriate routine: 


e For D PFK, DC,K, D U, and DUMP, 
control is returned to IEBECIR5O, which 
will issue SVC 110 to pass control to 
the Master Scheduler Router for further 
processing. 


¢ For all other commands having a CSCB, 
control is passed to the Queue Alter 
Syntax Check routine (IEESD562) via an 
XCTL macro. 


* For DEFINE, control is passed to 
ITEEDFINI via XCTL. 


MASTER SCHEDULER ROUTER ROUTINE 


In MFI systems, the Master Scheduler Router 
routine, module IEE00110 (which receives 
control when SVC 110 is issued), receives 
control from LEECIR50 to continue 
processing of DISPLAY U, DISPLAY C,Kk, 
DISPLAY PFK and DUMP commands. The Master 
Scheduler Router routine determines which 
command has been entered and passes control 
accordingly: 


e If the command is b U, control is 
passed to the DISPLAY Units routine, 
LTEE20110. 


e If the command is D PFK, control is 
passed to the DISPLAY PFK routine, 
TEE4O110. 


e if the command is D C,KkK, control is 
passed to the DISPLAY C,K routine, 
ITEE10110. 


e If the command is DUMP, control is 
passed to the DUMP processor, IELO60110. 


When processing by SVC 110 is complete, 
control is returned to the master scheduler 
resident command processor. 


QUKUE ALTER ROUTINE 


The master scheduler uses the queue alter 
routine (Chart 3) to handle the execution 
of commands that require access to or 
Manipulation of system queues. The 
commands processed by the queue alter 
routine include: CANCEL, DISPLAY (A, 
CONSOLES, jobname, N, Q), HOLD , MONITOR A 
RELEASE and RESET. 


The queue alter routine is a collection 
of several modules that check command 
syntax, Manipulate system queues and 
control blocks, and issue informational 
messages to the operator. It is entered 
via an XCTL macro instruction issued by the 
master scheduler command analyzer, 
IEECIR51, after it has deleted the command 
CSCB from the CSCB chain. 


The queue alter routine is common to 
both MFT and MVT systems with the following 
exceptions: 


e In MFT systems the queue alter routine 


receives control from IEECIR51 (a 
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module used only by MFT), via an XCTL 
macro instruction, and returns control 
to IEECIR50. In MVT systems the 
routine receives control from a module 
used only by MVT, via an ATTACH macro 
instruction, and returns control to the 
MVi module. 


® In MFT systems the queue alter routine 
Operates under control of the master 
scheduler TCB and is therefore part of 
the master scheduler task. In MVT 
systems the routine operates under 
control of its own TCB. 


e In MFT systems queue alter syntax check 
routine, IEESD562, tests for DISPLAY (A 
and CONSOLES) and MONITOR commands and 
passes control to the appropriate 
command processing routines. In MVT 
systems the processing of these 
commands is in no way associated with 
the queue alter routine. 


Because of these differences, the queue 
alter routine modules and the DISPLAY A and 
DISPLAY CONSOLES processing routines are 
described pelow, even though they are 
common to both systems. 


Re ee RR EEE RR STERNER EE 


Syntax check routine IEESD562 checks the 
syntax of the command parameter in the 
CSCB. If a search of the input work queues 
(SYS1.SYSJOBQE) is required for processing 
the command, the syntax check routine sets 
internal codes for the queue search and 
passes control to the ECB/IOB construction 
routine, LEESD582. If the command syntax 
is in error, control is passed to the 
service routine, IEESD565. If the command 
was a DISPLAY A or MONITOR A command, 
control is passed to the DISPLAY A routine, 
IEFESD566. If the command was a DISPLAY 
CONSOLES command, control is passed to the 
DISPLAY CONSOLES routine, IEEXEDNA. 


TINE (IE DISPLAY A 
routine I[EESD566 receives control from 
Syntax check routine IEESD562 when the 
DISPLAY A (active) command MONITOR A 
(active) command is entered. This routine 
constructs WTO messages containing the 
active job and stepnames and, if subtasking 
is included, a count of the number of 
subtasks within the job step. The DISPLAY 
A routine returns control to the master 
scheduler resident command processor. 


DISPLAY CONSOLES ROUTINE (IEEXEDNA): 
DISPLAY CONSOLES routine IEEXEDNA receives 
control from the Syntax Check routine 
IEESD562 when the DISPLAY CONSOLES command 
is entered. This routine issues a header 
message that describes the status message. 
It then constructs and issues a message 


describing the status of the hard copy log 
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(if one exists) and each console in the 
system, both active and inactive. When the Da 
message is issued, it returns to IEECIR50. | 


DISPLAY U ROUTINES (1E#20110, IEE21110, 
IE£22110 AND IER23110): The resident 
command analyzer routine (IEECIR50O) issues 
an SVC 110 to nandle processing of DISPLAY 
U commands. The master scheduler router 
routine (IEE00110), which is the first 
routine of SVC 110, passes control to 
IEE20110. This routine checks the command 
for syntax errors and if any are found, 
passes control to IEE22110 to issue an 
error message. If there are no errors, 
control passes to IEE21110 which assembles 
the display and passes control to IEE23110. 
This routine issues a WTO macro instruction 
to write the display to the operator 
console. When all lines have been written, 
IEE22110 issues a FREEMAIN macro 
instruction to free work areas and then 


returns control to the master scheduler 


router. 


DISPLAY PFK ROUTINE (IEE40110): The 

resident command analyzer routine 

(IEECIR50) issues an SVC 110 to continue 

processing of a DISPLAY PFK command. The 

master scheduler router (IEE0O0110), which 

is the first routine of SVC 110, passes 

control to ITEE40110. This routine checks 

the command syntax, assembles the display 

of commands associated with each PFK key go 
number, and issues a WTO macro instruction | . 
to pass the display to the operator ae 
console. When processing is complete, 

control is returned to the master scheduler 

router. 


DISPLAY C,K ROUTINES (IEE10110, IEE11110, 
AND IEE12110): The resident command 
analyzer routine (IEECIR50) issues an SVC 
110 to continue processing of a DISPLAY C,K 
command. The master scheduler router 
(ITEE00110), which is the first routine of 
SVC 110, determines that a D C,K command 
was entered and passes control to the 
DISPLAY C,K routine (IEE10110). This 
routine begins to assemble the display of 
CONTROL command operands, and issues a WTO 
Macro instruction to pass the display to 
the operator. The second DISPLAY C,k 
routine (IEE11110) and the third routine 
(IEE12110) continue assembling the display 
and issuing WTO macro instructions until 
the entire display is passed to the 
operator. When processing is complete, 
control passes back to the master scheduler 
router. 


+ 


Queue Search Setup Routine (IEESD563) 


The queue search setup routine determines 
which of the queues is to be searched and - 
reads the queue control record (QCR) for —_, 
that queue. If the queue must be searched, \ 
parameters for the search are established. 


% 
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e If the DISPLAY Q or DISPIAY N command 
is being processed and this is the 
initial entry to IEESD563, control 
passes to the DQ/DN message setup 
routine, IEESD584. 


e If the DISPLAY Q command is being 
processed, and an empty held queue is 
found, no further queue searching is 
needed, so control passes to the Queue 
Search Return Routine. 


e If all the queues selected are empty, 
Or for a jobname search with no match 
found, control passes to the Service 
Routine, IBLESD565. 


e If the CANCEL command is being 
processed with ALL or OUT specified and 
if all the output queues have been 
selected and at least one match found, 
control passes to the Queue Scratch 
Setup Routine, IEESD575. 


e If the HOLD 0 or RELEASE Q commands are 
being processed, the HOLD queue bits in 
the ACR are adjusted, the ACR rewritten 
into SYS1.SYSJOBQE and control passes 
to the service routine. 


* For all other commands, control passes 
to the Queue Search Routine, IFESD564, 
to begin or to continue the search. 
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Queue search routine IEESD564 reads the 
entries Of a queue based on the parameter 
information passed by setup routine 
IEESD563. If the command processing 
requires chances in the chaining 
information in a queue entry or control 
record, the updated information is written 
on the queue. If the DISPLAY N command is 


being processed, the name of each job and 


the queue in which it is found is written 
to the operator, and control is passed to 
the Queue Search Setup Routine to establish 
parameters for the next search. For all 
other commands, control is passed to the 
Queue Search Return Routine, IEESD583, to 
analyze and establish action indicators. 


Based on the information passed by the 
calling routine, service routine IEESD565 
performs the following: 


1. Passes control to queue manager 
enqueue routine IEFQMNOQG via a LINK 
macro instruction to enqueue an entry 
or GCR. 


23 Issues a FREEMAIN macro instruction to 
free the ECB/IOB which was used to 
read SYS1.SYSJOBOQOE. 


3. Passes control to the SVC 34 message 
module (IEE0503D) via a LINK macro 
instruction to write a message. 


4. If another queue needs to be searched, 
it passes control to queue search set 
up routine LEESD563 via an XCTL macro 
instruction. 


After the requested processing has been 
performed, the service routine transfers 
control to router routine IEECIR50. 


Queue Scratch Setup Routine (IEESD575) 


Queue scratch setup routine IEESD575 builds 
the parameter list for the SCRATCH macro 
instruction (SVC 29) according to whether 
the canceled job was found on the input or 
output queue(s). If the job was found on 
the input queue, IEESD575 determines 
whether there are SYSIN data sets to be 
scratched. If not, IEEFSD575 passes 
controlto queue alter delete routine 
IERSD576. If the job was found on the 
input or output queue with data sets to be 
scratched, IEESD575 passes control to queue 
scratch routine IEESD581. When IEESD581 
has scratched all data sets, IEESD575 
passes control to queue alter delete 
routine IEESD576. 


Queue Alter Delete Routine (IEESD576) 


Gueue alter delete routine IEESD576 passes 
control to queue manager delete routine 
IEFQDELE to delete the queue entries 
associated with the canceled job. Upon 
return from the delete routine, control is 
passed to the queue message class setup 
routine, JTEESD578. 


Queue Restart Engueue Routine (IEESD577) 


Queue restart enqueue routine IEESD577 
passes control to the queue manager enqueue 
routine TEFQMNQGO to enqueue the SYSOUT data 
sets for canceled restarting jobs. Upon 
return from IEFQOMNQQ, IEFSD57/77 passes 
control to IEESD579. 


Queue Message Class Setup Routine 
(LTEESD578) 


Queue message class setup routine IEESD578 
zeroes out the DSBs in the message class 
and sets up the queue manager parameter 
area for enqueuing the message class. If 
the job was a restarting job, IEESD578 
passes control to IEESD577. For a job on 
the output queue, with more queues to be 
searched, control is passed to IEESD563. 
If the CANCEL command was issued for a job 
that does not have the message class 
associated with it control is passed to 
message routine IEESD580 otherwise control 
is passed to queue SMB routine IEESD579. 
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Queue SMB Routine (IEEBSD579) 


Queue SMB routine IEESD579 places the 
appropriate cancel message into the first 
SMB and passes control to the queue manager 
engueue routine IEFQMNQQ to enqueue the 
message class. IEESD579 issues the cancel 
message to the operator and returns control 
to master scheduler resident command 
processor LTEECIR50. 


Message _kKoutine (TEESD580) 


Message routine IEESD580 issues cancel 
messages to the operator for those jobs 
that do not have the message class 
associated with them. It then returns 
control to master scheduler resident 
command processor, IEECIRS5O. 


Queue Scratch Routine (ITEESD581) 


gueue scratch routine IEFSD581 issues the 
SCRATCH macro instruction (SVC 29). Upon 
return from the Scratch service routine, 
IEESD581 issues a “data set not deleted" 
message if the return code is nonzero. 
TEESD581 returns control to queue scratch 
setup routine TEESD575. 


ECB/IOB Construction Routine (IEESD582) 

If the operand of the command contains a 
jobname, the ECB/IOB construction routine 
searches the chain of CSCB's for the 
corresponding CSCB. If a match is found, 
control passes to the service routine for 
the "job selected" message to be issued. 
If no match is found or if the operand of 
the command does not contain a jobname, a 
GETMAIN is issued to obtain storage and to 
construct an event control block, (ECB), 
and an input/output block, (10B). Control 
then passes to the queue search setup 
routine, IEESD563. 
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The queue search return routine obtains 
control from the Queue Search Routine, 
IEESD564, after a queue search has been 
completed. 


e If the DISPLAY jobname command is being 
processed and a jobname match occurs, 
the job status information is written 
to the operator. 


e If the DISPLAY Q command is being 
processed, the queue status and number 
of entries found in the search by 
ITEESD564 is written to the operator. 


e if the CANCEL command is being 
processed and a jobname match occurs, 
control is passed to the queue scratch 
setup routine, IEESD575. The queue 
search return routine determines 
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whether further queue searching is to 
be performed. If so, control passes to 
the gueue Search Setup Routine, 
IEESD563, to establish the new search 
parameters. If the queues to be 
searched are exhausted, control passes 
to the service routine to setup the 
appropriate message to the operator. 


/DN Message Setup Routine (IEESD584) 





The DQO/DN message setup routine writes the 
control and label lines for the queue or 
name display in response to a DISPLAY Q or 
DISPLAY N command. it then passes control 
to the queue search routine, IEESD564, to 
begin the search, unless the command was a 
DISPLAY Q and a empty field queue was 
found, in which case no search is needed, 
so control is passed to the search return 
routine, IEESD583. 


DEFINE COMMAND PROCESSOR 


The master scheduler resident command 
processor uses the DEFINE command 
processing routines (shown in Figure 9) to 
initialize or change partition definitions 
in MFT. These routines handle: 


e Commands from the operator via a 
console, issued after nucleus 
initialization, to change the size and 
description of any partition while 
processing continues in unaffected 
partitions. 


e Commands from the system at IPL time to 
prepare the partition as it was 
described at system generation. 


Ail transfers of control among the 
processing routines are accomplished via an 
XCTL macro instruction. 


DEFINE Command Initialization Routine 
(TEEDFIN1 ) 


The master scheduler passes control to 
DEFINE command initialization routine 
IEEDFIN1I whenever a DEFINE command is 
entered by the operator. The routine also 
receives control from the master scheduler 
during system initialization, after the 
nucleus initialization program (NIP) 
completes its preparation of the system. 

In either case the routine builds the 
DEFINE data area containing the size and 
description (job classes A-O, or R or W) of 
each partition If Main Storage Hierarchy 
Support is included in the system, the data 
area contains the size of the partitions in 
terms of hierarchies. Hierarchy 0 
represents processor storage and hierarchy 
1 represents 2361 Core Storage. 





If the time-slicing feature is included 
in the system, the data area also contains 
a doubleword of time-slicing information, 
including che first and last partition 
numbers in the time-slicing group and the 
time interval (in milliseconds) assigned to 
the group of partitions. This data is used 
at completion of DEFINE processing to 
Gefine the partitioning of main storage. 


If the DEFINE command initialization 
routine was entered as the result of a 
DEFINE command, the routine issues a DEFINE 
COMMAND BEING PROCESSED message to all 
active consoles. It then determines 
whether LIST was specified and if so, 
passes control to listing routine IEEDFING. 
If not, the routine passes control to 
message routine IEEDFIN5 for issuance of an 
ENTER DEFINITION message. 


If the DEFINE command initialization 
routine was entered during the system 
initialization, the routine also issues a 
DEFINE COMMAND BEING PROCESSED message to 
all active consoles. It then determines 
whether partition redefinition or LIST was 
specified by the operator, and if not, 
passes control to validity check routine 
IEEDFIN3. If either LIST or partition 
redefinition was specified, the routine 
continues processing as if a DEFINE command 
had been entered by the operator. 


Syntax Check Routine (IELEDFIN2) 


When syntax check routine IEEDFIN2 receives 
control at primary entry point IEEDFIN2, it 


translates the statements entered by the 
operator to upper case. When the routine 
receives control at secondary entry point 
LEEDPART, this operation is bypassed. 


The statement 1S scanned and each entry 
in the statement -- a partition definition, 
a time-slicing change, or a keyword -- is 
processed Separately. 


If the entry is a partition definition, 
the routine checks the entry for syntax 
errors. If a syntax error is found, the 
routine passes control to message routine 
IEEDFINS for issuance of the appropriate 
syntax error message. The erroneous entry 
and all following entries are ignored. If 
the syntax 1S correct, IEEDFIN2 updates the 
DEFINE data area with the partition 
information and gets the next entry for 
processing. 


If the entry is a time-slicing change, 
the routine passes control to time-slice 
check routine IEEDFIN6. 


If the entry is neither a partition 
definition, nor a time-slicing change, the 
routine assumes that it is a keyword and 
passes control to keyword scan routine 
ITEEDFIN7. 
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CIEEDFIN3) 


Validity check routine IEEDFiN3 (for 
processor storage) makes final checks to 
determine whetner the information entered 
by the Operator is correct (e.g., that the 
definition changes which have been 
reguested are within legal bounds or that 
the time-slicing specification is valid). 
If an error is detected, the routine passes 
control to LEEREXIT, a secondary entry 
point in command final processor routine 
IEEDFIN9. If the information is valid, the 
routine determines the partitions affected 
by the DEFINE command constructs a list of 
PIB pointers (one for each affected active 
partition) and passes control to validity 
check routine IEEDFINC. 


Validity Check Routine -~- Core Storage 


ee ee ee ee are ee en ee 


(IEEDFINC) 


Validity check routine IEEDFINC (for core 
storage) determines whether Main Storage 


Hierarchy Support is in the system. If it 
is not, control is passed to system 
reinitialization routine [BFEDCFINB. If it 


is, IEEDFINC determines whether a partition 
has been defined in two segments. If both 
HO and H1 Size have been reduced to zero, 
the routine marks the partition inactive in 
the DEFINE data area. it also checks to 
determine if a partition has been specified 
for excess bytes resulting froma 
redefinition in either HO or Hi of an 
adjacent partition. If no partition has 
been specified, the routine passes control 
to secondary entry point IEEREXIT in 
commana final processor routine IEEDFIN®S. 
Otherwise, it sets up a message indicating 
the number of excess bytes, the partition, 
and the hierarchy to which they have oeen 
added. It then passes control to IEEREXIT. 


If the information is valid, IEEDFINC 
passes control to system reinitialization 
routine [EEDFINB. 
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Listing routine IEEDFIN4 lists partition 
definitions and job classes. If the 
time-slicing feature is in the system, it 
also lists the time-slicing attributes. 
After performing the listing function, the 
routine determines whether an END keyword 
has been read from the console, and if so, 
passes control to validity check routine 
ITEEDFIN3. If not, it passes control to 
message routine IEEDFIN5S5. 


Message routine IEEDFIN5 handles the 
messages required by the DEFINE command 
processing routines. These messages, which 


are written to the operator, are concerned 
with: 


* Entering and continuing the definition 
of partitions. 


* Syntax, parameter, and time-slicing 
errors. 


e Tllegal number of partitions or 
oversize partitions. 


® Completing the definition of 
partitions. 


After issuing the appropriate message, the 
routine determines whether processing is 
complete and if so, issues a DEFINITION 
COMPLETED message to all active consoles. 
It then determines if a DEFINITION 
CANCELLED message has previously been 
issued and if so, tests to see if the 
system is being initialized. if the 
message has been issued and it is IPL time, 
IEFEDFINS passes control to command 
initialization routine IEEDFIN1 to repeat 
the DEFINE command processing. If the 
DEFINIYZION CANCELLED message has not been 
issued, or if it has been issued at other 
than IPL time, the routine returns control 
to the caller. 


If processing is not complete, IEEDFIN5 
passes control to syntax check routine 
TEEDFIN2. 


Time-Slice Syntax Check Routine (IEEDFIN6) 


Time-slice syntax check routine IEEDFIN6 
checks the time-slicing entry for syntax 
errors. If a syntax error is found. the 
routine passes control to message routine 
IEEDFINS for issuance of a PARAMETER ERROR 
message. it ignores the erroneous entry 
and all following entries. If there are no 
Syntax errors, the routine updates the 
DEFINE data area with the time-slicing 
information, gets the next entry in the 
Statement being processed, and passes 
control to secondary entry point IEEDPART 
in syntax check routine IEEDFIN2. 


Keyword Scan Routine (iEEDFIN7) 


Keyword scan routine IEEDFIN7 determines 
whether the entry being processed is a 
valid keyword. If it is not a valid 
keyword, the routine passes control to 
message routine IEEDFINS for issuance of a 
PARAMETER ERROR message. It ignores the 
erroneous entry and all following entries. 
If a valid keyword is found, the routine 
sets the appropriate keyword indicator in 
the DEFINE data area. 


If there are more entries to be 
processed, the routine gets the next entry 
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and passes control to secondary entry point 
ITEEDPART in syntax check routine IEEDFINZ. 


If there are no more entries to be 
processed (end of input), the routine 
determines whether a LIST keyword has been 
entered and if so, passes control to 
listing routine IEEDFING. If LIST was not 
specified, a check for the END keyword is 
made. if an END entry is found, the 
routine passes control to validity check 
routine IEEDFIN3. If an END entry is not 
found, the routine passes control to 
message routine IEEDFIN5 for issuance of a 
CONTINUE DEFINITION message. 


System Reinitialization Routine 1 
(IEEDFINS8) 


After the partitions have quiesced, 
IEEDFIN8 assigns protection keys (if the 
system is protected) and marks dispatchable 
partitions not of zero size. It makes one 
final check to determine that no more than 
15 problem program partitions have been 
defined. If an error is found, the routine 
passes control to secondary entry point 
IEEREXIT in command final processor routine 
ITEEDFINY. 


If no error is found, IEEDFINS8 uses the 
information in the DEFINE data area to 
build request blocks and boundary boxes and 
to update che TCBPIB field and the PIB for 
the defined partition. The routine then 
passes control to IEEDFINY at its primary 
entry point, IEEDFIN®9. ; 

Before passing control to IEEDFIN9 at 
either entry point, IEEDFIN8 issues the 
DEQUEUEL macro instruction specifying the 
boundary boxes. 


Command Final Processor Routine (ITEEDFIN9) 


Command final processor routine IEEDFIN9 
updates the time-slice control element and 
the task control biocks affected by 
time-slicing if this feature is specified. 


It then tests to determine if successful 
partition definition has taken place. If 
so, it tests the CVTSMCA field of the CVT 
for the address of the system management 
control area (SMCA). If this field 
contains zeroes, one Of two possible 
Situations exists: 


e SMF is not supported. 
e SMF is supported, but has not been 
completely initialized at this time. 


In either of these cases, or if partition 
definition has not completed successfully, 
IEEDFINS issues a FREEMAIN macro 
instruction to free the work area 
previously obtained by IEEDFIN3. It then 
passes control to IEEDFIN5 for issuance of 
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the appropriate message specified by its 
caller (IEEDFIN3 or IEEDFIN8). © 


If the CVISMCA field contains the 
address of the SMCA, SMF is supported and 
its initialization is complete. Partition 
definition has also completed successfully. 
Therefore, IEEDFINI passes control to 
IEEDFINA for creation of the SMF storage 
configuration record (type 13). Upon 
return from IBEDFINA, the command final 
processor routine passes control to 
IEEDFINS for issuance of the appropriate 
message. 


MFT Storage Configuration Record Creation 
Routine (ITEEDFINA) 


MFT storage configuration record creation 
routine [LEEDFINA creates the SMF storage 
configuration record (type 13). It 
receives control from SMF initialization 
routine IEESMFI2 during SMF initialization, 
and from command final processor routine 
IEEDFIN9Y whenever a DEFINE command is 
issued. It creates the SMF storage 
configuration record and issues an SVC 83 
to have it transferred to the SMF buffer. 
It then returns control to its caller. 


System Reinitialization Routine 2 
(ITEEDFINB) 


System reinitialization routine IEEDFINB 
places the ECB that must be posted by the 
affected partition in the PIB of the 
partition. If a partition has been marked 


inactive (i.e., no HO or H1 size is 


contained in the DEFINE data area), 
IEEDFINB sets the partition's iCB 
nondispatchable. If any partition being 
redefined contains a system writer, the 
routine posts the STOP ECB in the Start 
Parameter List to stop the writer as if a 
"Stop Writer" command had been issued from 
the console. Therefore the operator must 
issue a "Start Writer" command for any 
writer partition involved in the 
redefinition. 


The routine then issues the WAIT macro 
instruction for the posting of the ECB | 
list. After the ECB is posted, IEEDFINB 
issues the ENQUEUE macro instruction 
specifying the boundary boxes. 


System Task Control (STC) 


In MFT systems, system task control (See 
Chart 17) initiates the processing of all 
START commands except the START INIT 
command; the initiator acts as the 
controller and the router for all job 
scheduling in the system and receives 
control directly from SVC 34 when a START 
INIT command is issued. | 7 








START commands may be issued for system 
tasks (that operate in a zero protection 
key) or for problem programs (that operate 
in a protection key corresponding to the 
partition in which they are started). When 
the master scheduler determines that a 
START command with an identifier operand 
has been issued, it checks the validity of 
the partition specified in the command, 
builds and chains a CSCB, places a pointer 
to the CSCB in the partition's PIB, and 
posts the partition. 


Note: If the START command is issued for a 
Ssystem-assigned reader or writer, the CSCB 
pointer is placed in the master scheduler 
resident data area. 


Job selection module T#FSD510 responds 
when the partition is posted, and passes 
control to system task control whenever a 
START command other than a START INIT 
command is issued. STC processes a job 
description similar to a user's job 
description. 


The job description information for a 
task specified in a START command comes 
from three sources: the procedure library, 
job control language (JCL) statements, ana 
the operator. The procedure library 
contains standard descriptions of system 
tasks (the user may add descriptions of 
Other tasks to be established via START 
commands). JCL statements (corresponding 
in input stream JCL) are created 
internally; these statement invoke and 
modify the procedure. The operator 
furnishes additional information in the 
Operand of the START command; this 
information is edited into the internally 
created JCL statements before they are used 
to invoke and modify the procedure. 


Note: Because STC does not process the 
START INI% command, any further references 
to START commands in the “System Task 
Control" section of this publication will 
exclude consideration of a START command 
specifying an initiator. 





START COMMAND PROCESSING 


System task control processes START 
commands issued for system tasks. System 
tasks are those privileged tasks such as 
readers and writers that operate in a zero 
protection key and are listed by name in 
linkage table IEEVLNKT. 


System task control also performs 
processing for START commands issued for 
problem programs. Problem programs operate 
in a non-zero protection key and are not 
listed by name in the linkage table. In 
addition, data set integrity and job step 
timing are provided for them. Problem 








programs may be written by IBM with 
IBM-assigned names or they may be written 
by the user with user-assigned names. When 
the following conditions are met it is 
possible to start problem programs directly 
from the console via the START command: 


e The JCL for the problem program has 
been placed in the SYS1.PROCLIB data 
set. (The START command specifies the 
name of the procedure containing the 
JCL.) 


e The partition in which the problem 
program is to be started is a problem 
program partition. 


ee es Vg ge Roe 1 
{Attripute | System |Problem Program| 
| | Task |Started From | 
| | |The Console | 
|-------------— {-—-~~---- {--------------- ' 
| Protection Key |Zero |Non-zero | 
|-------------— an --------------- ' 
|Name in | | | 
| LEEVLNKT {Yes {No | 
~~-~----------- }---------}---------------} 
{Data Set {| TIEEVLNKT | Yes | 
J integrity | deter- | 
| |mines | | 
| {this | | 
~~----~--------}-~------- {--------------- ! 
Job Step Timing|No | Yes | 


(iaicaeiell aan ne eee 
The Differences Between System 
Tasks and Problem Programs 
Started from the Console 


Figure 10. 


START Commands Issued for System Tasks 


START commands are issued to schedule 
system tasks (see Figure 10). System task 
control performs the following functions 
prior to execution of the system task: 


e Builds and interprets the JCL necessary 
for processing the system task. 

e Constructs and initializes the control 
blocks and work areas necessary for 
execution of the system task. 

e Uses the I/O device allocation 
subroutine to allocate the necessary 
I/O devices, and to provide direct 
access space and the mounting of 
appropriate volumes. 

e Passes control to the system task 
specified in the START command. 


At termination of the system task, STC: 


e Uses the termination subroutine to free 
the I/O devices assigned to the system 
task, and to dispose of the data sets 
referred to or created during system 
task execution. 


e Releases the main storage occupied by 


the control blocks and work areas. 
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START Commands Issued for Problem Programs 


START commands are also issued to schedule 
problem programs (see Figure 12). In this 
case system task control: 


e Builds and interprets the JCL necessary 
for processing the problem program. 


e Performs processing necessary to bring 
an initiator into the partition 
specified in the START command. 


e Passes control to the initiator. 


It is important to note that the processing 
for problem programs started. directly from 
the console differs from that for problem 
programs entered through the input stream. 
For problem programs entered through the 
input stream, it is necessary to issue a 
START reader command to read and interpret 
the necessary JCL, and a START initiator 
command to bring an initiator into the 
partition for performance of the actual 
processing of the problem program. 


For problem programs started directly 
from the console, system task control 
performs the functions listed above, 
replacing those provided by the START 
reader and START initiator command 
processing routines. 
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systems, 


Another major difference to note is that 
while checkpoint/restart and system 
management facilities are provided for 
problem programs entered through the input 
stream, they are not available for problem 
programs started directly from the console. 


The System Task Control Routines 


Seven system task control routines are 
common to both MFT and MVT systems. Four 
of these routines (IEEVSTAR, IEEVJCL, 
IEEVRCTL, and IEEVRC) build and interpret 
the JCL necessary for processing a job. 
Although these routines are common to poth 
systems there are some differences in 
processing. Their descriptions are 
therefore included in this publication for 
the sake of clarity. The three other 
routines that are common to both systems 
are described in the MVT Job Management 
PLM. These routines include: internal JCL 
reader routine IEEVRJCL, interpreter post 
scan exit routine IEEPSN, and message 
writing routine IEEVSMSG. It should be 
noted that while IEFEVSMSG is used in both 
it receives control from different 
STC routines in the two systems. 
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Figure 12. Scheduling a Problem Program 
Started from the Console ina 
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LINKAGE ROUTINES (IEFSD586, IEFSD587, 
IEFSD588 _LPSW 
ROUTINES (IEFSD534, IEFSD535, IEFSD584, 
TEFSD585): In an MFT system, the initiator 
acts as the controller and the router for 
all job scheduling in the system. The 
initiator routines are therefore required 
to be in the supervisor state so that they 
may perform privileged operations. The 
system task control routines, however, do 
not perform privileged operations and 
therefore operate in the problem program 
State. ‘thus, it is necessary to maintain 
an interface between the initiator and 
system task control. 





TEFSD589, IEF589SP) AND LPSW 


oe Se 








This interface is accomplished by a 
series of linkage routines and LPSW 
routines. A linkage routine, Operating in 
the supervisor state, receives control from 
the initiator and passes control to a Load 
PSW routine via a LINK macro instruction. 
Therefore, when control is eventually 
returned to the linkage routine, the 
supervisor state of the linkage routine is 
maintained. The linkage routine is then 
able to return control to the initiator via 
an XCTL macro instruction, preserving the 
supervisor state of the initiator. (See 
Chart 17.) 


When a Load PSW routine receives control 
from a linkage routine, it issues a Load 
PSW instruction for entering the problem 
program State. All subsequent STC routines 
therefore operate in the problem program 
state. 


While different linkage routines and 
LPSW routines are used, depending on the 
STC processing required, their functions 
are all similar. One exception should be 
noted, however. Linkage routine IEFSD588 
does not pass control to a Load PSW 
routine. Instead, it passes control 
directly to transient reader linker routine 
IEF591SD via a LINK macro instruction. In 
this case, IEF591SD issues the LPSW 
instruction to enter the problem program 
State for system task control. 


START SYNTAX CHECK ROUTINE (IEEVSTAR): The 
START syntax check routine getsS main 
storage for, and builds, the start 
descriptor table (SDT) (see Figure 13). 
Seven entries are provided in the SDT: the 
first contains the JOB statement, the 
second contains the EXEC statement that 
calls the procedure specified in the START 
command, the remaining entries are provided 
for a DD statement and continuations of the 
EXEC and DD statements. Each entry 
contains a one-byte identification flags 
field, whose bits, when set to one, have 
the following meanings: 


® Bit O indicates a JOB statement. 
e Bit 1 indicates an EXEC statement. 


e Bit 2 indicates a DD statement. 

e Bit 3 indicates a DD statement 
continuation. 

e Bit 4 indicates an EXEC statement 
continuation. 

e Bits 5 through 7 are reserved. 


The routine generates the JOB, EXEC, and DD 
Statements that are placed in the SDT. The 
keyword parameters in the START command are 
compared with a list of keyword parameters 
that are allowable in a DD statement; they 
are not compared with DD subparameters. If 
the keyword corresponds to a member of the 
list, the routine stores it in the DD 
statement in the SDT. This DD statement 
overrides the IEFRDER DD statement in the 
procedure specified in the START command. 
If the keyword does not correspond to a 
member of the list, it 1S assumed to bea 
symbolic parameter keyword and is placed in 
the EXEC statement in the SDT. The routine 
then constructs the required allocate 
parameter list, and a JSCB and WTPCB in 
suppool 255 (SQA). It then stores the JSCB 
address in the [CB and CSCB. 


Finally, the syntax check routine passes 
control to JCL edit routine IEEVJCL. 
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Figure 13. START Descriptor Table (SDT) 
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JCL EDIT ROUTINE (IEEVJCL): JCL edit 
routine IEEVJCL builds the job control 
language set (JCLS). Using the information 
in the SDT, the JCL Edit routine puts the 
JCL in the form appropriate for the 
interpreter. Each statement is built in an 
88-character buffer (obtained with a 
GETMAIN macro instruction). A pointer to 
the first puffer is placed in the CSCB 
associated with the START conmand. Each 
buffer contains a pointer to the next 
buffer, 4 bytes of reserved space, and a 
"card image" of the statement in the last 
80 bytes. The routine then builds the 
following: 


e The Job Scheduling Entrance List 
(JSEL). 

e The Job Scheduling Exit List (JSXL). 

The Job Scheduling Option List (JSOL). 

The Option Buffer (OPT). 


READER/ INTERPRETER CONTROL ROUTINE 
(IEEVRCIL): Reader/interpreter control 
routine ITEEVRCTL receives control and 
builds the interpreter entrance list (NEL), 
Option list, and exit list, and the Job 
Scheduling Work Area (JSWA). interpreter 
entrance list contains the address of the 
JCLS in its third word. The routine also 
issues a LOAD macro instruction specifying 
internal JCL reader routine IEEVRJCL and 
interpreter post scan exit routine IEEPSN 
so that these modules may be used by the 
reader. ITEEVRCTL then creates entries in 
the NEL exit list for these modules and for 
interpreter exit routine IEEVRC. The 
reader/interpreter control routine then 
frees main storage used for the JSOL and 
the OPT and passes control to the reader 
Via an XCTL macro instruction. 








The nonzero value of the third. word of 
the entrance list indicates that the input 
stream is an internal data set. Since the 
input stream is internal, the reader issues 
a pseudo OPEN macro instruction to bring a 
special access method (a modified QSAM) 
into storage and places a pointer to the 
access method in the input DCB. This 
special access method reads the JCLS;,.it is 
entered from the expansion of the standard 
GET macro instruction. 


The internally-stored job control 
language statements, and the statements 
from the procedure library are analyzed and 
combined. The standard job description 
tables are built, and an input queue entry 
is constructed; however, because bit 7 of 
the option switches field of the option 
list is off, the entry is not enqueued, and 
the reader or writer "job" cannot be 
selected by an initiator. If errors are 
detected during reader processing, 
appropriate messages are placed in system 
message blocks, which are enqueued in the 
message class queue. When processing is 
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complete, the reader places the main 
storage address of the job control table 
(JCT) in the NEL and passes control to 
interpreter exit routine IEEVRC via an XCTL 
macro instruction specifying the exit list 
entry for IEEVRC created by the 
reader/interpreter control routine. 


INTERPRETER EXIT ROUTINE (IEEVKC): When 
interpreter exit routine IEEVRC receives 
control, it issues a DELETE macro 
instruction specifying the internal JCL 
reader routine and the interpreter post 
scan exit routine. Routine IEEVRC writes 
the logical track header (LYH) onto the job 
queue and uses the Queue Management 
routines IEFCNVRI and IEFRDWRT to indicate 
that, for warm start, the job should be 
processed as if it had been degqueued from 
an input queue. It analyzes the return 
codes from the reader and the scan routine 
and performs the appropriate processing. 
For internal JCL errors and for I/O errors, 
it initializes the CHSPA field of the CSCB 
with an appropriate error code. (These 
error codes are explained in the 
description of the CSCB found in Appendix 
A.) If a system task is being started and 
either of these types of errors is 
detected, the interpreter exit routine sets 
the job-failed bit in the JCT to terminate 
the starting task. For all other errors, 
IEEVRC also sets the job-failed bit in the 
JCT to terminate the starting task. 


The interpreter exit routine then frees 
Main storage for the JCLS, the 
reader/interpreter register save area, the 
NEL, the options list, and the exit list. 
It also frees main storage for control 
blocks used by MVT systems (i.e., JSWA, 
JSEL, and JSXL). ~ 


If the START command was issued for a 
system task, the routine then passes 
control to allocation interface control 
routine IEEVACTL. If the START command was 
issued for a problem program, the 
interpreter exit routine determines if the 
partition specified in the START command is 
a problem program partition. If not, the 
routine sets the job-failed bit in the JCT 
to terminate the starting task, and issues 
an appropriate message to the operator. It 
then passes control to the allocation 
interface control routine. 


If the START command was issued for a 
problem program specifying a problem 
program partition, IEEVRC returns control 
to linkage module IEFSD589 with a return 
code of four in register 15. 


ALLOCATION INTERFACE CONTROL ROUTINE 
(IEEVACTL): The allocation interface 
control routine sets up the necessary 
parameter list for IEEVSMSG to issue the 
WrO macro instruction to inform the 








Operator of any errors that have been 
found. Finally it passes control to the 
I/O device allocation routine via a LINK 
macro instruction. 


I/O device allocation routine IEFSD210 
uses the JCT to find the appropriate tables 
in the input queue, allocates the necessary 
devices to the reader or writer, and issues 
any necessary mounting messages. The 
allocation recovery routines issue WTO 
macro instructions to inform the operator 
of any errors found during allocation. 

When allocation is complete, or if 
allocation cannot be performed, control is 
returned to the allocation control 
interface routine. 


Allocation control interface routine 
IEEVACTL determines if the routine to be 
given control is an authorized routine and 
then transfers control to Write TIOT 
routine IEESD590. 


Note: The linkage table contains a list of 
all “authorized" routines. The module name 
of this table is IEEVLNKT. It is used by 
both MFT and MVT systems and its format may. 
be found in the “Command Processing" 

section of the MVT Job Management PLM. 


QOMPA BUILDER ROUTINE (IEEVSMBA): The QMPA 


builder routine obtains main storage for 
and builds: 





e The message class queue manager 
parameter area (QMPA). 


e Its associated ECB/IOB. 


It uses the Queue Management Read/Write 
Routine to read in the SYSOUT class 
directory (SCD) for the task from the job 
queue. It uses information in the SCD to 
initialize the QMPA. IEEVSMBA then builds 
the ECB/IOB for the QMPA and stores the 
address of the QMPA in the LCT. 


The QMPA builder routine then returns 
control to its caller. 


WRITE TIOT ON DISK ROUTINE (IEESD590): 
Write TIOT on disk routine IEESD590 writes 
the TIOT and checks to see if a system task 
is to be started in a small partition. If 
not, it passes control to linker routine 
IEESD591 via an XCTL macro instruction. If 
so, the routine posts the "no work" ECB in 
the PIB. It then posts the ECBA in the 
SPIL with a completion code of zero to 
indicate to small partition routine 
IEFSD599 that initiation services have been 
performed and that the system task is ready 
to be executed. The routine then waits on 


the ECBC in the SPIL. When the ECBC is 
posted by the small partition routine, 
IEESD590 returns control to linkage routine 
IEFSD589. 


LINKER ROUTINE (IEESD591): The linker 
routine (load module IEESD591) consists of 
two assembly modules: IEESD591 and 
IEE591SD. The routine is entered at 
IEESD591 from write TIOT routine IEESD590. 
It passes control to the system task 
specified in the START command via a LINK 
macro instruction. When the task stops or 
Suspends processing, control is returned to 
the linker routine. If an I/O error 
occurred, IEESD591 issues the ABEND SVC. 
The routine then returns control to the 
appropriate calling routine. 


The routine is entered at IEE591SD from 
linkage routine IEFSD588 to restore a 
transient reader. It issues a Load PSW 
instruction to enter the problem program 
state. It then passes control to the 
transient reader via a LINK macro 
instruction. When the transient reader 
stops or suspends processing, control is 
returned to ITEE591SD, which returns control 
to linkage routine IEFSD588. 


TERMINATION INTERFACE CONTROL ROUTINE 
(IEEVTCTL): The termination interface 
control routine sets up the necessary 
tables and parameters for termination 
processing and passes control to 
termination entry routine IEFSD420 via a 
LINK macro instruction. Upon return from 
termination, it frees main storage used for 
the various tables and passes control to 
POST routine IEESD592 via an XCTL macro 
instruction. 


MESSAGE WRITING ROUTINE (IEEVOMSG) : 
Message writing routine IEEVOMSG assembles 
and writes messages to the operator for 
termination interface control routine 
IEEVTCTL. 


POST ROUTINE (IEESD592): POST routine 
IEESD592 posts the “no work" ECB in the 
PIB. If termination services have been 
performed for a small partition, the POST 
routine also posts the ECBA in the SPIL 
With a completion code of two to indicate 
that job termination has taken place. Ifa 
CSCB address has been passed to IEESD592, 
the routine removes the CSCB from the CSCB 
chain and frees the main storage that it 
occupied. Finally, the POST routine 
adjusts the boundary box contents to 
indicate that the partition is now cleared 
for further processing, and returns control 
to the appropriate calling routine. 
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PART 4: COMMON ELEMENTS OF JOB 


Job management routines frequently refer to 
Or execute system elements that are also 
used by other job management routines. 
common elements of job management are 
discussed below. 


The 


e The work queues are the temporary 
storage areas that permit work to be 
stored in input sequence, and to be 
processed in priority sequence. They 
act as buffers between the | 
interpreters, initiators, and system 
output writers, allowing each to 
process at maximum speed. 


optional feature of the control program 
that provides a means for gathering and 
recording the type of information that 
can be used to evaluate system usage. 


e The write-to-programmer facility 
enables the operating system to provide 
the user with information about his job 
in the event of an abnormal occurrence 
during execution. This information is 
conveyed to the user via messages to 
the system message class output data 
set. 


Work Queues 


MFT and MVI systems use the same job queue 
data set (SYS1i.SYSJOBQE). It consists of 
work queues that occupy space on a 
permanently resident volume. The space for 
the job gueue data set is allocated when 
the system is generated in response to a DD 
Statement submitted by the installation. 
The DD statement specifies the amount of 
space (contiguous tracks) to be allocated. 


The work queues forming the job queue 
data set consist of: 


e The automatic 
queue. | 
The HOLD queue. 

The remote job entry (RJE) queue. 
36 output class queues. | 
15 input job class queues. 
The background reader (BRDR) 
20 unused queues. 


SYSIN batching (ASB) 


queue. 


In MFT systems the background reader queue 
is also unused. 
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job queue data set is allocated. 


MANAGEMENT 


The job entries are enqueued in priority 
order within each job class on the 
appropriate job class queue. Jobs are 
selected for processing according to the 
job class designation of the partition 
requesting work. 


QUEUE MANAGEMENT 


Queue Management is a general term 
describing a group of routines used by 
various system components, such as the 
reader/interpreter, initiator/terminator, 
and output writer. The queue manager 
performs some common functions for all 
system components. It performs all 
input/output for accessing the job queue 
data set and keeps track of all space on 
this queve. The queue manager assigns 
Space on the job queue in logical track 
increments for control blocks, tables, 
system messages built by the scheduler. 
When the control blocks and tables have 
been created, the reader/interpreter 
enqueues (ENQs) the job using the queue 
Manager. After the job is enqueued, the 
initiator dequeues (DEQs) the job for 
execution when a partition that is assigned 
to service that job class becomes available 
for work. The terminator places control 
information needed by the system output 
writer on the job queue. At job 
termination, the terminator enqueues the 
output work description. The writer then 
dequeues the output work according to 
output class and priority within the class, 
and transcribes it to the appropriate 
device, specified by the user. 


and 


At system generation, the space for the 
The 
device upon which the job queue resides is 
considered a non-demountable system 
residence volume. 


MFT uses the MVT Queue Manager. 
However, to reduce possible interlocks due 
to unavailability of requested tracks, the 
assign routine (IEFQASGQ) has been 
modified, and another module (IEFSD572) has 
been added. The discussion of the queue 
manager includes descriptions of some MVT 
modules to provide a more complete 
explanation of the relationship of these 
modules to the entire system. A discussion 


of the transient queue manager (SVC 90) is Me 


also included. 








JOB QUEUE INITIALIZATION 


At system initialization, queue 
initialization routine IEFSD055 receives 
control from the SET command processor to 
construct a data control block (DC8) in the 
nucleus, and to issue an OPEN macro 
instruction which causes a data extent 
block (DEB) to be built for accessing 
SY¥S1.SYSJOBQE. It also places a queue 
manager master queue control record (master 
QCR) in the nucleus after the DCB and DEB. 
The master QCR contains information about 
the queue data set as a whole, and is used 
in the control and maintenance of the 
free-track gueue. (See Figure 14 for the 
format of the master QOCkK.) Control then 
passes to queue formatting routine 
LEFORMAT. 





0 (0) 
8 byte disk address of the Master QCR 
MBBCCHHR 
8 (8) 2 
Displacement of first track 
Reserved of the free queue Reserved 
12 (C) 2 
Number of logical tracks in Number of logical tracks in 
the job queue data set the free-track queue 
16 (10) 
Number of tracks reserved Number of tracks reserved 
for cancelling of job steps for Any initiator 
when queue full 
20 (14) 
Displacement of last Displacement of first track 
available logical track containing only job queue 
records 
24 (18) 9 
Number of QCRs per Number of job queue records 
physical track per physical track 
28 (1C) 
Number of records per Number of logical tracks 
logical track for each Problem Program 
partition 
32 (20) Ad ; 2 
Niainhen ee OCkeea ihe dress of first record on 
: first track containing only 
mixed track 
job queve records 
36 (24) 
Master Queue Control Record 


Figure 14. 
| (Master QCR) Format 


The queue formatting routine divides the 
job queue data set into a control record 
area and a logical track area. The control 
record area contains a copy of the master 
QCR, and a QCR for each of the remaining 
queues. Each QCR is used in the 
maintenance of a single queue; there is one 
ASB queue control record, one HOLD queue 
control record, one RJE queue control 
record, 36 output queue control records, 15 
input queue control records, one BRDR queue 
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control record, and a queue control record 
for each of the 20 unused queues. (See 
Figure 15 for the format of an input queue 
control record.) 


Note: The first position of the job queue 
control record (job QCR) contains zeros if 
no work exists. The job QCR contains a 
minimum of two entries if work exists for 
at least one priority. 


The job class specified by the user (on 
the JOB statement or in a STAR? command) is 
converted by the system to match the 
system-assigqned job class identifiers. The 
user-assigned job class and corresponding 
system job class identifiers are: 


System-Assigned 
Identifier 
(Hexadecimal) _ 


User-Assigned 
Job Class 


28 
29 
2A 
2B 
2C 


OSZSRrFRAHTOAHMmMUONWPE 
Nh 
ry 


The logical track area length is 
variable. Logical tracks are used instead 
of physical tracks so that the job queue 
can reside on different device types. Each 
logical track contains a 20-byte header 
record (LTH) (as shown in Figure 16) which 
includes a pointer to the next track. The 
header record is used to chain all tracks 
of a job together. When the job is 
enqueued, the header record is used to 
chain jobs first-in/first-out (FIFO) 
according to priority. All jobs of the 
same job class are chained together. 
Following the header record are a variable 
number of 176-pyte data records. The 
number of records per logical track is 
determined at system generation and may 
range from 10 to 255 records. The number 
may be modified within this range at IPL. 
All tables, control blocks, and system 
messages are in 176-byte increments. 


At system initialization, all tracks are 
members of the free track queue. The free 
track queue is a list of logical’ tracks 
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available for assignment to work queues. QUEUE MANAGER MODULES 


As tracks are needed, they are taken from ee 
the free track queue. When the system is As jobs are read into the system, they are | 
finished with tracks, they are returned to placed into each job class queue according Sus? 
the free track queue. After system to priority (established by the PRTY 
initialization, SYS1.SYSJOBQE appears as parameter on the JOB statement). When the 

shown in Figure 17. Figure i8 illustrates reader/interpreter reads a job or 

typical input and output work queues. Each establishes a new queue for an output 

input and output QCR contains the address class, it establishes a queue entry. This 

of the last entry in each priority queue. is done by Assign/Start Routine IEFQASGT. 


Address of last LTH of highest priority entry on queue, 


Addresses of last 
LTH of latest 
entry having 
indicated priority. 


Highest 
Priority 


Address of ECB for first task requesting work 





Figure 15. Job Queue Control Record (QCR) 
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Offset 
Dec Hex 
0 (0) 
Jobname or No-Work Chain Element 
8 (8) 2! Number of | 
Function NN of First Logical Track Records 
Code Assigned to this Entry Assigned in 
this Track 
12 (C) Number | 
NN of Next Logical Track of Logical 
Tracks 
Assigned 
16 (10) 
Job 
Status Priority NN of Next Queue Entry 
Code 
20 (14) 


* Job Type Code 
1 = HOLD queve 
2 = ASB queue 
3-38 = Output class queues 
39 =RJE queve 
40-54 = Input work queues 
55 = BRDR queve 


Logical Track Header (LTH) 
Record Format 


Figure 16. 


Assign/Start Routine (IEFQAGST) 


The Assign/Start routine takes the first 
track from the available track pool and 
establishes it as the first track for a 
job. The queue manager parameter area 
(QMPA) is updated accordingly. (See the 
MVIT_ Job Management PLM for a description of 
QMPA.) An IOB and an ECB are created for 
subsequent input/output operations. The 
actual reserving of tracks is done by the 
assign routine, IEFQASGQ. 


Note: MFT does not support the 
track-stacking facility of MVT. 





Assign Routine (IEFQASGQ) 


The assign routine assigns record space on 
the job queue, and determines whether the 
requested blocks can be assigned to the 
current track. If so, the record addresses 
are placed in the external parameter list 
of the QOMPA, and the records-available 
field of the QMPA is decremented to reflect 
this assignment. If additional logical 
tracks must be assigned, this routine 
issues an ENQ macro instruction on the 
master QCR to prevent concurrent access by 
other tasks. The master QCR is read into 
Main storage. 
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The primary user of this assign routine 
is the reader/interpreter, although the 
initiator/terminator also uses it. To 
prevent the possibility of the 
reader/interpreter taking all the space and 
making it impossible for jobs to be 
initiated or terminated, two limit values 
have been added: the number of tracks 
reserved for initiating a job, and the 
number of tracks reserved for terminating a 
job. 


If logical tracks are available, the 
requested tracks are acquired. The address 
of the first available logical track is 
updated and the newly assigned tracks are 
chained to the tracks assigned to the job. 
The master QCR is written to the control 
record area of the job queue data set. A 
DEQ macro instruction is issued to make the 
master QCR available to the next user. 


If there are no available logical 
tracks, and the requesting routine is a 
reader/interpreter, the assign routine 
passes control to queue manager/interpreter 
interlock routine IEFSD572. If the 
reader/interpreter is resident, control 
returns to the assign routine to wait for 
tracks to become available. If the 
reader/interpreter is transient, IEFSD572 
issues a message to the operator requesting 
him to reply “WAIT" or "CANCEL". If the 
reply is WAIT, control returns to the 
assign routine, otherwise control is passed 
to the ABEND routines to cancel the 
reader/interpreter. 


If there are no available logical tracks 
and the requesting routine is an 
initiator/terminator, the assign routine 
issues a message to the operator stating 
that queue space has been exceeded and 
passes control back to the 
initiator/terminator to cancel the job. 


When the requesting routine is assigned 
the record TTRs, it can read and write 
records on the job queue. The master QCR 
is written, and a DEQ macro instruction is 
issued to make the master QCR available to 
the next user. The record addresses in 
storage and TTR pointers are contained in 
the external parameter list of the QOMPA. 
When available space on the job queue 
becomes critical, a warning is sent to the 
requesting task. Logical tracks are 
removed from the pool of available tracks 
and assigned to the job. 


If the reply is CANCEL, the interlock 
routine deletes all queue space assigned to. 
the job, cancels the job, and returns 
control to the assign routine. Normal 
initiator operation recovers the partition 
for further use. 
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36 36 36 1296 
Master QCR Hold QCR ASB QCR 


36 Output QCRs 
(Classes A - Z and 0 - 9) 












| 36 Control 
RJE QCR Record 
7 Area 
15 Input QCRs 
(Classes A - O) 
BRDR QCR 
Reserved -_ 
720 
(20 Unused QCRs) 
First 176 - byte record 
First 
Logical 
Wags P| Additional 176 - byte records 
Logical 
eit Track 
rg 176 - byte records Area 
Last 
Locical 176 - byte records 
Track 


Figure 17. Sample Job Queue (SYS1.SYSJOBQE) Format After Initialization 
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Only Priority 6 
Entry Enqueued 





First Priority 2 
Entry Enqueved 


ee a ee 


Highest Priority 







3 


LTH First Logical Track 


3 
Last Priority 2 





Last Priority 2 


Second Logical Track Entry Enqueved 


4 


4 
< 

| 

§__)——_' 


LTH Last Logical Track 





| | 
| Logical | 176-byte data records | 
Output Work QCR | Track | (Number of data records per logical ! 
| ie | Header | track is specified at SYSGEN) l 
| / | | | 
| jy LTH First Logical Track 
| / First Priority 10 


Entry Enqueved 
L 


4 


H Last Logical Track 


= LTH 
JOB QUEUE 


ce aN Se 
Entry Enqueued 


/ 
yi | 
j | 
Input Work QCR L 
Highest Priority ence 
L 
Last Priority 10 
Last Priority 6 LTH Last Priority 6 
Entry Enqueuved 
Last Priority 2 
Only Priority 2 
um PP Entry enqueue 


Figure 18. Input and Output Queue Entries 
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ie LS A I NE NN SO RR ee a -CE 


(LEFSD572) 


When the reader/interpreter requests tracks 
for the job it is processing, and no space 
is available, IEFQASGQ passes control to 
interlock routine IEFSD572 to identify 
whether an interlock can occur. If the 
reader is transient, the possibility exists 
that space needed by the reader/interpreter 
can be provided only by the termination 
routines, which must operate in the 
partition that the reader occupies. 

Because the requested space is not 
available, the routine issues a message to 
the operator requesting a reply of ‘WAIT' 
Or 'CANCEL'. If the reply is WAIT, this 
routine returns to the assign routine to 
Wait for available space. (if the reader 
requesting space is a resident reader, no 
message is issued, and a reply of WAIT is 
assumed.) 


If the reply is CANCEL, control passes 
to delete routine IEFODELD to delete all 
queue space assigned to the job being 
processed (if any space had already been 
assigned). When control returns, the 
interlock routine abnormally terminates the 
job with a job-canceled code of 222. 

Normal initiator operation recovers the 
partition for further use. 


Queue Manager Engueue Routine (TEFQMNQQ) 


After all control blocks for a job have 
been written, the job is eligible for 
selection by an Initiator. Declaring a job 
ready for selection (enqueuing) is done by 
Queue Manager Enqueue routine IEFQMNOQ®O. 


When an interpreter has completed the 
processing of a job, (all records generated 
by the interpreter have been written on the 
queue), it uses this routine to enqueue the 
job, in priority order, on the appropriate 
job class input work queue. When a job 
completes processing, the terminator uses 
this routine to enqueue output data sets, 
in priority order, on the appropriate 
Output work queues. 


TO prevent concurrent updates, this 
routine issues an ENQ macro instruction for 
the queue control record (QCR) of the 
proper queue. When the QCR becomes 
available, it is read into main storage. 
The enqueue routine then places the new 
queue entry after the last entry with the 
same priority as shown in Figure 16. The 
address of the new entry is then placed in 
the track header of the prior entry 
(maintaining a chain), and in the QCR 
position for that priority. The job 
control table (JCT) is written. The 
updated QCR is written on the job queue. A 
DED macro instruction is issued making the 
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QOCkK available. Control is then returned to 
the calling routine. 


Degqueue Routine (IEFQMDQQ) 


In addition to déqueuing a job from the 
input queue for an initiator, the dequeue 
routine (IEFQMDQQ) removes the output data 
from an output queue for processing by a 
system output writer. 


The routine issues an ENO macro 
instruction on the QCR of the selected 
queue. When the QCR becomes available, the 
dequeue routine reads it into main storage. 
The QCR is examined for a job belonging to 
the same job class as the partition. Upon 
finding a job, this routine adjusts the 
chain. If none is found, the requesting 
task tries the next job class. If no work 
is found on any of the selected queues (up 
to three), the requester places itself ina 
wait state. In the case of an output 
writer, a pointer to the "no work" ECB is 
placed in the QCR. If a pointer already 
exists, the ECB is chained to the last ECB 
waiting for that output class. Then the 
updated QCR is written and a DEQ macro 
instruction is issued making the QCR 
available. 


Once a job has completed processing, or 
the output writer has written all records 
for a job, the tracks are returned to the 
system. This is known as deleting a job 
and is handled by the queue manager delete 
routine IEFQDELQ. 


Delete Routine (IEFQDELQ) 


The Delete routine first issues an ENQ 
macro instruction on the master QCR of the 
free chain of tracks. After control is 
returned, the record is updated to refiect 
the new available tracks. The prior last 
track of free storage is updated to point 
to the new set of free tracks. After the 
master QCR is updated, it is written anda 
DEQ macro instruction is issued against it. 
The ECB indicating wait-for-space is 
posted. 


Figure Breakup Routine (IEFSD514) 


When a reader must be suspended, the job 
scheduler must prevent the destruction of 
variable size tables in main storage. To 
do this, it calls the queue manager table 
breakup routine, IEFSD514, (Chart 4) which 
subdivides tables in main storage and 
writes them on disk as 176-byte data 
records. The data records are written in a 
queue entry related to the caller. The job 
scheduler calls IEFSD514 to retrieve the 








176-byte data records and to reconstruct 
the tables in main storage. Whether 
reading or writing tables, the caller must 
build a parameter list (see Figure 19) and 
place the address of the list in general 
register 1 before calling the TBR. 





0 (0) 
Address of QMPA 
4 (4) 
Address of First Record (Head TTR) 
8 (8) 
Address of Table 1 
12 (C) 
Table 1 ‘ 
Sunes Size of Table 1 
16 (10) 
Address of Table 2 
20 (14) 
Table 2 . 
Subpoo| Size of Table 2 
24 (18) 
Address of Table n 
Table n Size of Table n 
Subpoo| 
Figure 19. Table Breakup Parameter List 


When the tables are written initially, 
the TBR parameter list must contain the 
address of a QMPA specifying the queue 
entry into which the tables are to be 
written. The function code field (QMPOP) 
Of QMPA must specify a write operation. 
The TBR parameter list must also contain 
the address, subpool, and size of each 
table to be written. The last word of the 
TBR parameter list must be zero. The TBR 
returns a Head TTR address which locates 
the beginning of the tables on disk. This 
TTR must be saved for subsequent retrieval 


of the tables. 


The initial write establishes disk data 
records for the tables for the duration of 
the associated queue entry (i.e., until the 
entry is deleted). Therefore, further 
write requests must specify the Head TTR in 
the TBR parameter list. Before issuing a 
write request, the caller must retrieve any 
previously written tables to prevent their 
being overlaid by the new write request. 
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and processing continues. 


If the request is for output of tables, 
(transferring from main storage to direct 
access device), the Head TTR (passed in the 
parameter list) is used to read the first 
table queue control record (TQCR). If the 
Head TTR is zero, the assign routine, 
IEFQASGO, is called to assign space fora 
new TQCR. The TOCR is a 176-byte record 
containing a 4-byte forward-chain pointer 
and space for 43 TTRs. These spaces are 
filled in as the tables are written, using 
the assign routine to assign the TTRs, and 
the Read/Write routine, IEFQMRAW, to write 
the tables in 1i176-byte segments. If more 
than 43 records are required to hold the 
tables, a new FQOCR is chained to the first, 
The low-order 
byte of the last TYR used in writing the 
tables is set to 'FF' (hexadecimal) to 
indicate end-of-tables. After these TTRs 
are assigned, they are used each time the 
table breakup routine is called to write 
tables, as long as the dead TTR is 
preserved by the caller. 


Once a queue entry has been deleted, a 
caller must issue another initial write 
request (Head TTR is zero in the table 
breakup routine parameter list) to 
establish a new string of table data 
records. IEFSD5i14 does not free table 
storage areas. 


In retrieving tables, the TBR parameter 
list must contain the address of an 
associated QMPA. The function code (QMPOP) 
field must specify a read operation. ‘The 
TBR parameter list must also contain the 
Head TTR address. Sufficient space must be 
allowed for the [BR to return the new main 
storage address of each table, and the 
Subpool and size of each table as specified 
when they were written by the TBR. 


If the request is for input (reading 
into storage) of tables, the first TOCR is 
read into storage using the Head TTR passed 
in the parameter list. The first record of 
the first table is read, using the first 
record in the TQCR. This record contains 
the size of the table and the number of the 
desired subpool. IEFSD514 issues a GETMAIN 
specifying the subpool and the amount of 
Storage required for the table. The 
remainder of the table is then read into 
the storage obtained, using read/write 
routine I[EFQMRAW. Each table specified in 
the parameter list is processed in this 
manner until ‘FF' (hexadecimal), indicating 
end-of-tables, is found. As each table is 
read into main storage, the parameter list 
is updated with the main storage address of 
that table. When all tables have been 
read, control is returned to the caller. 
The address of the updated parameter list 
is returned in register 1. Figures are 
always written in the same sequence that 
they appear in the TBR parameter list, 
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beginning with the Head TTR. They are 
retrieved, totally, in the same sequence; 
they cannot be read selectively. 


Transient Queue Manager Routines (IEFXQMOO, © 





TEFXQMO1, and IEFXQMO2) 


The transient queue manager consists of 
initialization and read/write routine 
IEFXQOMO00, track assignment routine 
IEFXQM01, and record assignment routine 
IEFXOMO02. These routines provide the 
services of assign/start routine IEFQAGST, 
assign routine IEFOQASGO, and read/write 
routine IEFQMRAW. The transient queue 
manager is in SYS1.SVCLIB and operates in 
the transient SVC area. 


When the transient queue manager 
initialization and read/write routine 
IEFXQM0O receives control it first 
initializes an ECB/IOB and prepares the 
QOMPA. If the queve manager was requested 
to provide a track or record, IEFXQM00 
branches via an XCTL macro instruction to 
track assignment routine IEFXQM01 or record 
assignment routine IEFXQM02. If the queue 
Manager was requested to read or write a 
record onto the job queue, ILEFXQM00 
performs the read or write. IEFXQM00 
returns control to the caller upon 
completion, as does IEFXQM01 and IEFXQM02. 


System Management Facility 


The system management facility is an 
Optional feature of the control program 
that provides a means for gathering and 
recording the type of information that can 
be used to evaluate system usage. It 
consists of routines that collect data, 
routines that record the collected data in 
a data set, and routines that provide 
interfaces for exits to user-supplied data 
collection routines. The system management 
facility may include either one tape data 
set (SYS1.MANX) or two direct access data 
sets (SYS1.MANX and SYS1.MANY). In the 
latter case, the two data sets are filled 
alternately: while one is in use, the 
other may be dumped via the SMF dump 
routine (IFASMFDP). 


SMF data collection routines and exits 
for user-supplied data collection routines 
are in the Supervisor, the Interpreter, the 
Initiator, and the Termination routines. 
IBM-supplied data collection routines are 
in the Supervisor, the System Output Writer 
and the Vary Command Processor. 


The routines that record the data in the 
SMF data set include the SMF SVC routines 
(svc 83) and the SMF writer routine 
(IEESMFWT). 
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COMPARISON OF SMF IN MFT AND MVT 


The areas of SMF processing that are the 
same in MFT and MVT include: 


e The SMF SVC routines (SVC 83). 
e The SMF dump routine. 


e The SMF processing in the Interpreter, 
the System Output Writer, the VARY 
Command Processor, and the Termination 
routines. 


This processing is described in the MVT Job 
Management PLM. 


Additional SMF processing in MFT job 
Management routines differs from MVT only 
in the manner in which it is implemented. 
The areas of difference in implementation 
occur in: 


® The SMF initialization procedure. 
e The SMF writer routine. 


e The SMF processing in the initiator. 


SMF processing in the Initiator is 
described in the “Job Processing" section 
of this publication. The SMF writer 
routine and the processing for SMF 
initialization is described below. 


The SMF records are the same for MFT and 
MVI, except for the addition of an SMF 
storage configuration record (type 13) in 
MFT. A description of the SMF records, 
showing the data elements that occur in 
each record type and the source from which 
each data element is obtained, is found in 
the "Common Elements of Job Management" 
section for the MVT Job Management PLM. 


SMF Initialization 


In MFT the routines initializing the system 
Management facility operate under the SMF 
TCB and the master scheduler TCB. (See 
Figure 20.) SMF writer routine IEESMFWT 
executes under the SMF TCB. It is 
initially involved in a WAIT/POST 
interchange with the SMF initialization 
routines operating under the master 
scheduler TCB. (This is to ensure that the 
system management control area (SMCA) is 
initialized and that IEESMFWT has access to 
it before the writer routine begins 
initialization processing.) The SMF writer 
routine's primary initialization function 
is to issue an SVC 83 for the opening and 
allocation of the SMF data sets. 
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Figure 20. SMF Initialization Processing Flow 
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The other SMF initialization routines 
execute under the master scheduler TCB. 
SMF initialization routine IEESMFIT adds 
the SMF DD names to the master scheduler 
task input/output table (TIOT) and reads 
the SMF parameter member SMFDEFLT from 
SYS1.PARMLIB. SMF parameter processing 
routine IEESMFI3 processes the SMFDEFLT 
parameters and/or the SMF parameters 
entered from the console. SMF 
initialization routine IEESMFI2 initializes 
the 10-minute timer queue element (TQE) and 
constructs the SMF IPL and online device 
records. SMF open initialization routine 
IEESMFOI initializes the job file control 
blocks (JFCBs) for the SMF data sets and 
posts the SMF writer routine for the 
opening and allocation of these data sets. 
SMF storage configuration record creation 
routine IEEDFINA constructs the SMF storage 
configuration record (type 13). 


When the SMF writer routine is 
dispatched, it stores the address of a 
local ECB in the TCBTCT field of the SMF 
TCB. (This local ECB provides 
communication between the master scheduler 
and SMF tasks. It is posted by IEESMFIT or 
by IEESMFOI after the address of the SMCA 
has been stored in the CVTSMCA field of the 
CVT.) The SMF writer routine then issues a 
WAIT macro instruction specifying the local 
ECB. 


SMF initialization routine IEESMFIT 
receives control from master scheduler 
initialization routine IEFSD569 via a LINK 
Macro instruction. When it is entered, it 
adds the compiled-in DD names SMFMANX and 
SMFMANY to the master scheduler TIOT and 
stores the address of the master scheduler 
TIOT in the SMCATIOT field of the SMCA. 
(For the format and description of the 
SMCA, see “Appendix A™ in the MVT Job 


Management PLM.) 


The SMF initialization routine then 
checks SYS1.PARMLIB for the existence of 
the SMF parameter member, SMFDEFLT. If it 
does not exist, the routine passes control 
to IEESMFI3 at entry point IEESMFMS. 
Otherwise, it opens the SYS1.PARMLIB data 
set and reads SMFDEFLT into main storage. 
If an I/O error occurs during the reading 
of the data set, IEESMFIT passes control to 
IEESMFI3 at entry point IEESMFIO. 


When it has completed reading in the SMF 
parameter member, IEESMFIT passes control 
to IEESMFI3 to determine if all of the 
parameters have been entered correctly. If 
sO, IEESMFI3 stores the SMF parameter 
values in the SMCA. If any required 
parameters are missing or incorrectly 
specified, or if IEESMFI3 was entered at 
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IEESMFMS or IEESMFIO, the routine issues a 
WIOR macro instruction to request the 
Operator to enter the SMF parameters to 
make the appropriate corrections. When he RG. 
has entered the parameters correctly, 

IEESMFI3 stores the values in the SMCA. 

The routine then issues a WTO macro 

instruction to display the parameters. It 

then inspects the parameter associated with 

the OPI keyword. If the parameter is 

“YES", Operator intervention is allowed. 

IEESMFI3 therefore issues a WTOR macro 

instruction to allow the operator to make 

changes. When the changes, if any, have 

been stored, IEESMFI3 returns control to 

IEESMFIT at entry point IEESMFI4. 


ae 


IEESMFIT then determines if an SMF data 
set is specified by testing the SMCAMAN bit 
in the SMCAMISC field of the SMCA. If the 
bit is off, an SMF data set is not 
specified. In this case, IEESMFIT prepares 
to return to the master scheduler 
initialization routine, because SMF 
recording will not be possible. It stores 
the address of the SMCA in the CVTSMCA 
field of the CVT. It then issues a POST 
macro instruction specifying the local ECB 
to indicate to the SMF writer routine that 
the SMCA is initialized and its address 
stored in the CVT. IEESMFIT then issues a 
WAIT macro instruction specifying the 
buffer ECB (SMCABECB). 


When the local ECB is posted the SMF 
writer routine has access to the SMCA. It, 
therefore issues a POST macro instruction 
specifying the buffer ECB, to indicate that 
the writer is ready and waiting for work. 
The SMF writer routine will now wait on the 
writer ECB (SMCAWECB). 


When the buffer ECB is posted, the SMF 
initialization routine is activated. It 
returns control to master scheduler 
initialization routine IEFSD569. 


If an SMF data set is specified, 
IEESMFIT continues with initialization 
processing. It issues a GETMAIN macro . 
instruction specifying the system queue 
area to obtain main storage for the SMF 
buffer. It then passes control to SMF open 
initialization routine IEESFMOI via a LINK a‘ 
macro instruction. 


The SMF open initializer prepares to 
have the SMF data sets opened and 
allocated. It compiles the JFCBs for the 
data sets (SYS1.MANX and SYS1.MANY) and 
uses the Queue Management Assign/Start and oo Ss 
Read/Write routines to obtain space in the 
work queue data set and to write the 








JFCBs.3 It stores the JFCB addresses in the 
master scheduler TIOT and stores the : 
address of the SMCA in the CVTSMCA field of 
the CVT. It indicates completion of this 
action to ITEESMFWT by issuing a POST macro 
instruction specifying the local ECB. It 
then issues a WAIT macro instruction 
specifying the buffer ECB. 


When the local ECB is posted the SMF 
writer routine has access to the SMCA. It 
therefore issues a POST macro instruction 
specifying the buffer ECB, to indicate that 
the writer is ready and waiting for work. 
The SMF writer routine stores pointers to 
the DCBs for the SMF data sets in the SMCA 
and then waits on the writer ECB. 


When the buffer ECB is posted the SMF 
open initialization routine is activated. 
It sets the “first time switch" (SMCAFIRT) 
in the SMCA miscellaneous indicators field 
to specify that the primary data set is to 
be opened. It also sets the “unconditional 
Switch bit™ in the SMCASWA switches field 
to specify an unconditional data set 
Switch. (This bit is set to indicate to 
the SMF writer routine that register 1 must 
be negative when the SVC 83 for opening and 
allocation of the SMF data sets is issued.) 
IEESMFOI then issues a POST macro 
instruction specifying the writer ECB to 
activate the SMF writer routine. 


When the SMF writer routine determines 
that the “unconditional data set switch 
bit" is set, it loads register 1 with the 
address of the SMCA. It then sets register 
1 negative and issues an-SVC 83 for the 
opening and allocation of the SMF data 
sets. (The SVC processing for SMF 
initialization is described in the 
"Initialization and Restart" section of the 


MVI_ Job Management PLM.) 


Upon return from the SMF SVC routines, 
the SMF writer routine issues a POST macro 
instruction specifying the buffer ECB, to 
indicate to IEESMFOI that opening and 
allocation are completed. It will now wait 
on the writer ECB until its services are 
again requested. 


When the buffer ECB is posted, IEESMFOI 
is activated and it returns control to 
IEFSMFIT. The SMF initialization routine 
tests the SMCA miscellaneous indicators 
field to determine if SMF recording will be 


1The JFCB records appear as an incomplete 
queue entry. In the event of a system 
restart, the system restart routines 
return the space occupied by the JFCB 
records to the free-track queue, and the 
SMF open initialization routine replaces 
them when it is executed again. 
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performed. If not, IEESMFIT returns 
control to master scheduler initialization 
routine IEFSD569. 


If SMF recording is implemented, 
IEESMFIT passes control to SMF 
initialization routine IEESMFI2. This 
routine constructs the SMF IPL record (type: 
0) and the SMF online devices records (type 
8). If volume accounting is specified, it 
also issues an SVC 78 for construction of 
the SMF LSPACE records (type 19). It 
issues an SVC 83 to have the records 
transferred to the SMF buffer. 


IEESMFI2 then branches to the timer 
enqueue routine (IEFAQTEOO) in the timer 
second level interruption handler to adda 
compiled-in timer queue element (TQE), 
requesting 10-minute time intervals, to the 
timer queue. It then passes control to 
IEEDFINA via a LINK macro instruction. 


IEEDFINA constructs the SMF storage 
configuration record (type 13). It issues 
an SVC 83 to have the record transferred to 
the SMF buffer. Upon return from the SVC 
routines, IEEDFINA returns to IEESMFI2, 
which returns to IEESMFIT, which returns to 
master scheduler initialization routine 
IEFSD569. 


The SMF Writer Routine (IEESMFWT) 


The SMF writer routine is the resident wait 
routine of the SMF task. It executes under 
a system TCB (the SMF TCB). It is 
initially involved in a WAIT/POST 
interchange with the SMF initialization 
routines executing under the master 
scheduler TCB. This is to ensure the SMF 
writer routine that the SMCA is initialized 
and its address stored-in the CVT, before 
the writer routine performs its SMF 
processing. 


When the SMCA is initialized, IEESMFWT 
issues a WAIT macro instruction specifying 
the writer ECB. The SMF writer routine 
regains control each time the ECB is 
posted, and performs one of the following 
functions: 


e It requests opening of the SMF data 
sets. 

e It requests data set switching. 

e It writes the contents of the SMF 
buffer in the SMF data set. 

e It determines if the SMF data set 
contains enough storage space for a 
record that must be written in 
segments. 


These functions are implemented in the same 
manner for MFT and MVT. They are described 
in the “Common Elements of Job Management" 


section of the MVT Job Management PLM. 
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Write-to-Programmer Facility 


The user can invoke the write-to-programmer 
facility by specifying a routing code of i1 
in the WTO/WTOR macro instruction (see the 
MFT Supervisor PLM for a discussion of the 
write-to-operator routine). When the 
write-to-operator routine (SVC 35) is 
entered, it examines all WTO/WTOR messages 
for a WTP routine code of 11. If sucha 
code is specified, WTO passes control to 
the Write-to-programmer Initialization 
rouine (module IEFWTP00). This routine 
initializes registers and a work area 
before passing control to the 
Write-to-programmer Message Processing 
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routine (module IEFWTP0O1). The WTP Message 
Processing routine uses the Transient Queue 
Management routines (SVC 90) to read, 
write, and assign SYS1.SYSJOBOF records for 
WIP messages. If an I/O error occurs in 
the job queue that is processing the WIP 
messages or if no record is available for a 
WIP message, the Write-to-programmer Error 
Processing routine (module IEFWTP02) 
receives control. 


The three write-to-programmer routines 
are the same for the MFT and MVT 
configurations of the control program. For 
a detailed description of these routines, 
see the "Common Elements of Job Management" 
section of the MVI Job Management PLM. 








APPENDIX A: TABLES AND WORK AREAS 


This appendix contains descriptions and format diagrams of the major tables and work 
areas that are used by MFT job management. The tables and work areas are in alphabetical 
order, as shown below: 


Command Scheduling Control Block (CSCB) 
Data Set Enqueue (DSENQ) Table 
Interpreter Work Area (IWA) 

Job Control Table (JCT) 

Job File Control Block (JFCB) 

Job File Control Block Extension (JFCBX) 
Life-of-Task Block (LOT) 

Linkage Control Table (LCT) 

Master Scheduler Resident Data Area 
Partition Information Block (PIB) 

Small Partition Information List (SPIL) 
Step Control Table (SCT) 

Step Input/Output Table (SIOT) 

Task Input/Output Table (TIOT) 
Write-to-Programmer Control Block (WTPCB) 


Tables and work areas are shown four or eight bytes wide for convenience, but are not 
necessarily drawn to scale. Tables that are stored in work queue entries are limited, by 
convention, to a length of 176 bytes. 


The names of most fields are sufficient to describe the fields; those that require 
further explanation are described in the text accompanying the table. Where a macro 
instruction may be used to include a DSECT of a table in routines using the table, the 
name of the mapping macro instruction is also given. The displacement of each field is 
shown to the left of each table; the values in parentheses show the hexadecimal 
displacement. 


COMMAND SCHEDULING CONTROL BLOCK {(CSCB) 


Description: A command scheduling control block (CSCB) (Figure 21) is an area for 
communications between the command scheduling routine (SVC 34) and the command execution 
routines. Input CSCBs are created by several system routines. When an input CSCB is 
created, it is placed ina chain of CSCBs by the command scheduling routine. It remains 
in the chain until it is deleted from the chain by the command scheduling routine, which 
may also free the main storage occupied by the CSCB. An input CSCB is created under the 
following circumstances: 


e A CSCB is created by the command scheduling routine each time a task-creating command 
is encountered. If the task is a reading or writing task, the CSCB is deleted from 
the chain, and its main storage released, when the task terminates. 


e A CSCB is created by the queue management dequeue routine each time the initiator 
dequeues a job. This CSCB is deleted from the chain, and its main storage released, 
when the last step of the job has terminated. 


e A CSCB is created by a system output writer each time it encounters a DSB that was 
not preceded by another DSB in the current queue entry. The CSCB serves as a 
communication area, allowing the cancelation (by operator command) of the subtasks 
established by the writer. The CSCB is deleted from the chain, and its main storage 
released, when the writer encounters an SMB (or the last block in the current queue 
entry). 


A control CSCB is updated (and changed to the control format if necessary) by the command 


scheduling routine when a CANCEL jobname (job selected), CANCEL writer device, MODIFY, or 
STOP command is encountered. 
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Although most of the fields are self-explanatory, the following require further 


description: a 
® Verb Code: This byte contains a code corresponding to the command for which the CSCB 
has been created. 

* Status Flags: This byte indicates the status (pending/not pending) of the CSCB, and 
the action to be taken by the command scheduling routine. In addition to command 
processing, the command scheduling routine may be entered to add the CSCB to the 
chain, delete it, free its main storage, or to branch to the abnormal termination 
routine. 

Name Bit Setting | Meaning 
CHAP 0 1 Assignment pending 
CHSYS 1 0 Problem program CSCB 
1 System task CSCB 
CHSOUT 2 1 Cancel all SYSOUT 
CHOSPC 3 il Insufficient queue space for 422 ABEND 
CHAD 4 1 Add this CSCB to the chain 
CHDL 5 1 Delete this CSCB from the chain. 
CHFC 6 1 Free this CSCB's core 
CHABYERM 7 1 Execute branch entry to ABLERM 

e Activity Flags: This byte indicates the type of activity with which the CSCB is 

associated. 

-Name Bit Setting Meaning 

CHSWAP 0 1 Job qualifies to be swapped (TSO only) 
CHTERM 1 1 Terminal job 

CHRESA 2 Reserved 

CHRESB 3 Reserved 

CHCL 4 1 Cancelable job step 

CHCLD 5 1 Cancel communication switch 

CHATFX 6 1 Cancelable (MFT only) 

CHIFY 7 1 System assigned procedure (MFT only) 

e Communication Flags: This byte indicates the function to be performed by the command 
processing routine. 

Name Bit Setting Meaning 

CHRESC 0 Reserved 

CHICT 1 1 Reader return with in-core JCT 

CHPSD 2 1 Writer pause data set 

CHPSF 3 1 Writer pause forms 

CHAC 4 1 ID specified on START command 

CHDSI 5 0 Data set integrity 
1 No data set integrity 

CHHIAR 6 0 HO specified on START command 
1 H1 specified on START command 

CHDEF 7 0 Use hierarchy specified by CHHIAR 
1 Default to HO 

e Express CANCEL Flags: This byte indicates the parameters passed with the CANCEL 

command to the CANCEL processor. 

Name Bit Setting Meaning 

CHALL 0 1 ALL specified 

CHINN 1 1 IN specified 

CHOUT 2 1 OUT specified 

CHHOLD 3 1 HOLD queue specified 

CHQUE 4 1 Specific queue specified » 
CHDUMP 5 1 Dump specified . 
CHJB 6 1 End scan ‘. 
CHRESD 7 Reserved 
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e MFT STC Switches: 


ee ee ES LK 


routine of System Task Control. 


Code Meaning 

X'OO" No errors for started system task 
xX'80' JCL error for started system task 
X'81' I/O error for started system task 
xX'CO' No errors for started problem program 
X'c4' JCL error for started problem program 
9 ae Go Be I/O error for started problem program 


Mapping Macro Instruction: IEECHAIN 


24 


32 


160 


Figure zi. 


CHPTR 
Address of the Next CSCB in the Chain 


Reserved 


CHUCMP 
UCMI 


CHBUF 
Command Operand 


This byte contains codes set by the reader/interpreter control 


CHACT 
Activity Header 
Flags 


CHTJID 


Terminal [D 


Reserved 


CHPEND CHINC 
Address of the Chain of Unique Counter for 
Pending START Commands the Interpreter 


Reserved 





Input CSCB 


Command Scheduling Control Block (CSCB) 
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CHPTR 
Address of the Next CSCB in the Chain 


CHSTS CHACT 
Status Activity 
Flags Flags 


CHKEY 


Procedure Identification or Taskname 


CHUNIT 
Unit Address of the Device 


CHECBP 
Address of the STOP /MODIFY ECB 


CHPRTY ! 
Reset 
Priority 


CHECB 
STOP / MODIFY ECB 


CHSWT 


Communications 
Flags 


CHTCB 
Address of the STC TCB 


CHSPC 
Address of the SPIL or TTR of the Transient Reader or 
Completion Code for ABTERM (MFT) 


CHQPA 
Queue Manager Parameter Area 
(Input Queue) 


CHUSC 
Length of the TIOT 


Control CSCB 


CHCIBCTR © 
CIB Count 
Assigned to the Procedure Field 


Command Scheduling Control Block 


CHCLS 


Procedure Name 


1) CHPKE 


Protect 
Key 


CHUCMP 
UCMI 


CHTJID 


Terminal ID 


CHCIBP 
Address of the CIB 


Reserved 


CHCECB 
CANCEL ECB 


Reserved 


CHSPB 
Address of TCB for ABTERM (MFT) 


CHIJCL 
Address of the JCLS or JCT 


CHSQA 
Queue Manager Parameter Area 
( Output Queue ) 


CHJSCB 
Address of the JSCB 


Reserved 





(CSCB) (Part 2 of 2) 


Header 








DATA SET ENQUEUE TABLE (DSENQ) 


Description: The data set enqueue table (DSENQ) (Figure 22) is built by the DD statement 
processor routine of the interpreter, and is used by the initiator to construct an ENQ 
macro instruction parameter list to prevent routines performing different tasks from 
using the same exclusive data sets concurrently. The table contains an entry for each 
data set (except temporary data sets) required for a job. 


Queue Address of This DSENQ Table Table ID 


Queue Address of Last DSENQ Table 


Name of Characters in all DSNAME Entries to Date 


Number of DSNAME Entries 
to Date 


Last DSNAME Entry * 


Zeros - ** 
End of DSENQ 





Exclusive/ Length of Dare.sét Name 


Shared DSNAME 





*%* If the last entry uses the last available space in the tables but no overflow occurs, 
the zero bytes are omitted. 


Figure 22. Data Set Enqueue Table (DSENQ) 


INTERPRETER WORK AREA (IWA) 


Description: The 2048-byte interpreter work area (IWA) (Figure 23) is obtained from 
subpool zero by a GETMAIN macro instruction in the interpreter initialization moduie 
(IEFVH1). The IWA contains information used by the interpreter routines; it is the area 
in which job description tables are built before they are placed in the work queues. 


Although most of the fields in the interpreter work area are self-explanatory, the 
following require further description: 


e Default Parameters: The PARM field of the EXEC statement in the reader procedure 
contains parameters to be used when no explicit specification is made. These 
parameters specify whether the installation requires a programmer's name or account 
number on each JOB statement, the priority to be assigned to a job if no priority has 
been specified, whether commands in the input stream should be processed (or 
ignored), and the device, primary quantity, and secondary quantity to be allocated to 


system output data sets. 


e® Switches A-I: These fields contain internal switches used for communicating status 
information among the interpreter routines. 
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Switch A: 


Name 


JTOP 
JHS 
JCTTOQ 
SCTTO 
DFSH 
JFSH 
EOFR 
SAFSH 


Switch B: 


Name 


CXP 
CXPN 
CXPC 
CANDD 
DDAST 
DDATA 
FRCV 
SFJIN 


Switch C: 


Name 


JCTRIN 
IOERR 
NRCV 
PEXP 
VOLTO 
DSNTQ 
PLSMB 
QMERR 


Switch Ds: 


Name 


JOBROLLF 
JOBREGNS 
FEXRCV 
FDDRCV 
DBFST 
DBLST 
DCTFST 
SYMPRC 


Switch E: 


Name 


PROC 
GPI 
PREF 
PRCV 
CONCAT 
POVRD 
POVRX 


Job Management with 


Setting 


Setting 


Bit 
0 1 
1 1 
2 i 
3 1 
4 1 
5 1 
6 7 
7 1 

Bit 
0 1 
1 1 
2 A 
3 1 
4 1 
5 1 
6 1 
7 1 


Bit Setting 


SOO WN FO 
ER ER RR Rb 


wo 
> 
ctr 


Setting 


WAU FWNKRO 
a ee 


wo 
nae 
cr 


SOO WN FO 


Setting 


BRR PR Re 


Meaning 


Job to process 

Job has a step 

JCT to put on queue 
SCT to put on queue 
Data flush 

Job flush 
End-of-file received 
Flush to a /* 


Meaning 


Continuation expected by Scan 
Continuation expected and not received 
Continuation expected and canceled 

DD * generated 

DD * or DD data 

DD data 

First statement received 

Search for job name 


Meaning 


CSCB return 

I/O error on input 

Null statement received 

Procedure EXEC statement expected 
Volume table to put on queue 

Data set name table to put on queue 
Put last SMB for this step on queue 
Queue manager I/O error 


Meaning 


Roll on job statement 

Region on job statement 

First EXEC received this job 
First DD received this job 
First entry to DSENQ 

Last entry to DSENOQ 

First dictionary entry received 
First access of a procedure 


Meaning 


Procedure library being used 

Get procedure library input 
Procedure library end-of-file 
Prime procedure buffer 
Concatenation in merge 

Override procedure DD statement 
Override procedure EXEC statement 
Unused 
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Switch F: 


Name Bit Setting Meaning 
ORPARMOR 0 1 Parameter override 
ORPARMBL 1 1 PARM parameter present 
ORCONDOR 2 1 Condition override 
ORTIMEOR 3 1 TIME override 

ORTIMEO 4 1 TIME = zero 

ORACTOR 5 1 ACCT override 

ORREGOR 6 1 Region override 
ORROLLOR 7 1 Roll override 


Switcno G: 


Name Bit Setting Meaning 
ORRDOR 0 1 Reader override 
ORSDPOR 1 1 Step dispatching priority override 
2= 1} Unused 

Switch Hs: 
Name Bit setting Meaning 
PCPCOMM 0 1 PCP working on command 
RDRDCBO 1 1 Reader opened 
PROCDCBO 2 1 Procedure library opened 
CPSYSFLG 3 1 Checkpoint restart EXEC statement 
CP FLGXX 4 1 Reserved for checkpoint restart 
PROCSW 5 1 Statement invokes a procedure 
CPSTPFL 6 1 Checkpoint restart step flush 
PCPSYSIN 7 af SYSIN DD * encountered in PCP 


Switch I: 


Name Bit Setting Meaning 
BLKPRC 0 1 Block procedure library 
IWABAS 1 i. Bypass Assign/Start 
IWADDNM 2 1 DDNAME = Key this card 
IWAKGSW 3 1 Blocked procedure PCP 
BLKMLTER 4 1 Procedure library blocksize 
DSNLIT 5 1 DSN = ‘'LITERAL'‘ 

6 Reserved 
SPOOLDD 7 1 DD * or data indicator 


Switch K: This field contains the Priority Change Value for the CHAP macro 
instruction. 


Switch L: This field contains the Default Allocation level in MSGLEVEL. 
Switch Ms: This field contains the Default JCL level in MSGLEVEL. 


Switch N: This field contains the length of the fixed part of the message for 
symbolic parameter substitution. 


Switch Ki: This field is set to X'80" for a search of the DDNAME reference table or 
to X'40" for SYSOUT. 
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® Checkpoint/Restart Switches: These fields contain switches that communicate 


checkpoint/restart status information to the interpreter routines. 





CHECKPOINT RESTART SWITCHES A: 


Name Bit setting Meaning 
0-1 Unused 
JOBRDNR 2 1 RD=NR 
JOBRDNC oS 1 RD=NC or RD=RNC 
JOBRDR 4 1 RD=R or RD=RNC 
a=7 Unused 


CHECKPOINT RESTART SWITCHES B: 


Name Bit Setting Meaning 
CPFiG 0 3 GET/FREE SYSCHECK DD statement core 
1 Unused 
CPDUM 2 1 Dummy step control table required step flush 
CRRES1 3 Reserved 
CRRES2 4 Reserved 
CRRES3 5 Reserved 
CRRES4Y 6 Reserved 
CRIMRS 7 1 Immediate restart (PCP) 


e Scan Switches: This field contains internal switches used by the Scan routines. 


Name Bit Setting Meaning 
RPRSW 0 1 Right parenthesis switch 
PDELSW 1 tome Period delimiter switch 
ASTSW 2 1 Asterisk switch 

FLUSHSW 3 1 Flush switch 

LDL 4 1 Last delimiter switch 
DCSSW 5 1 DCB switch 

J GC 6 1 Text sublist switch 

F ERROR 7 1 Error switch 


e Control and Scan Joint Switches: This field contains switches set by the Control 
routines to pass information to the Scan routine. 


Name Bit Setting Meaning 

CMT 0 1 Comment switch 

DDOV 1 1 DD override switch 

ENDS 2 1 End scan switch 

COLST 3 1 Column 72 (continuation) switch 
JOBSW 4 1 JOB switch 

EXECSW 5 1 EXEC switch 

DDSW 6 1 DD switch 

SNPSW 7 1 Statement SYSOUT switch 


e Exit Switches: This field contains switches indicating conditions which cause exits 
to user routines. 


Name Bit Setting Meaning 
0-3 Unused 
IWATRKS 4 1 Track stacking 
IWAQFIOE 5 1 Job queue full 
IWASFIND 6 1 Special procedure library FIND 
IWAQENTR 7 1 Special queue manager entry 


e System Input Allocation Table: This area contains a list of pointers to the UCBs 
corresponding to units available for allocation to system input data sets. 


e Data Delimiter: This area contains the valid DLM value. 
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Queue Address Table: This area contains the addresses (in TTR form) of the next two 
records assigned to the job's input queue entry, and the addresses (in TTR form) of 
the first joblib SIOT, the first scan dictionary record, and the DD override table. 


Input Stream Parameter List: This area describes the statement last encountered in 
the input stream, and contains a pointer to the field currently being processed. 


the procedure library, and contains a pointer to the field currently being processed. 








Procedure Library Parameter List: This area describes the statement last read from 





Procedure Library Merge Control Data: This area contains information used in merging 
statements from the input stream with statements from the procedure library. The 
information includes the statement names, the step names, and the names of the 


previous and next procedure steps. 








Mapping Macro Instruction: IEFVMIWA 
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24 


32 


40 


48 


72 


80 


88 


96 


104 


112 


120 


176 


184 


192 


200 


208 


216 


Figure 23. 


Unique Name Serial Number 


JFCB Address (LWA) 


Dictionary 1 Address (IWA) 


IWAINTS6 
Data Delimiter 


IWAID 
IWA Identifier 


CSCBP 
NEL Address 


PDCBP 
Procedure Library DCB Address 


DPQTY 
Primary Quantity 


1 ] 


OSW2 
Option 
Switches 


DINBPLPI 
Bypass Label 
Processing 


DUNAME 


1 
DROLLFLT 
Roll Defaults 


UNQNAME 
Unique Name Qualifier 


1) pmsctas | 


Default 
Msgclass 


2) DJBCLAS 
Maximum 
Jobclass 





SWB 
Switch B 


JCTS SCTS 
JCT Address (IWA) 


SCT Address (IWA) 


JFCBXS 
JFCBX Address (LWA) 


DREFBS 
Dictionary 2 Address (IWA) 


SYSNJFCB 
JFCB Address 


SYSNTTR 
TTR of JFCB (IEFDATA) 


IWAINTS1 
Spool DCB Address 


IWAINTS4 


Blocked PROCLIB Buffer Address 


IWANLRC 
No. of Blocked 
PROCLIB Records 


IWAL 
IWA Length 
(8) 1] 
IWAEXTS IWAFINDP 
Exit Switches Entry Point of FIND 
(10) 
RDCBP 
Input Stream DCB Address 
(18) ] ] 
OsSW] DINPRTY DTIME 
Option Switches} Job Priority Step Time 
(20) 
DSQTY DINMMEM 
Secondary Quantity Region Size 
(28) 
DUNAME (cont.) 
Default SYSOUT Unit Name 
(30) 
DINTPPRI 
Interpreting Priority 
(48) 
UNNU 
Reserved 
(50) 
QMGRP 
Queue Manager Entry Point Switch A 
(58) JEDSWS 
SWE SWF JOB, EXEC, or 
Switch E Switch F DD Switches (LWA) 
(60) 
JACTS SIOTS JFCBS 
JACT Address (LWA) SIOT Address (LWA) 
(68) 
VOLTS DSNAMES SREFBS 
VOLT Address (IWA) DSNAME Address (IWA) 
(70) 
POVRRDS ACTS 
POVRRD Address (IWA) ACT Address (IWA) 
(78) 
System Input Allocation Table 
(BO) 
(B8) 
IWAFDATA 
Unit Type For CPO Step I/O Table 
(CO) 
IWAINTSO 
Master Scheduler Register Save Area Address 
(C8) 
IWAINTS3 
Exit List Accounting Entry Address 
(DO) 
IWAINTSS5 
Job Management Record Address 
spe) IWAINTSS | 


SWH SWG 
Switch H Switch G 


SWI 
Switch | 


Ckpt/Restrt 
Switches A 


Interpreter Work Area (IWA) 
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Default 
Parameters 


Task 


Information 


Offsets 
to Table 
Areas 


(continued) 220 (DC) 











QPARM 
Queue Manager Parameter Area (QMPA) 








256 (100) 


TNEXT 
Next 2 Available TTRs 







264 (108) 










TSIOT 
Next Available SIOT TTR 


TJOBLIB 
TTR of JOBLIB SIOT 







272 (110) 












TSREFB 
TTR of First Dictionary 


TACT 
TTR of Override ACT 


RSTMT 
PSTMT 
PDNM 
PSNM 
RDNM 
Procedure 
Library 
| Merge 
RSNM Control 
Data 
PPSN 
Job 
ORIDSNM Information 


QPARMP 
Address of QMPA 





280 (118) 






TPROC 
Next PROC Step Override Table 











288 (120) 





RSTMT (cont. ) 


Input Stream Parameter List 


296 (128) 





PSTMT (cont. ) 


Procedure Library Statement Parameter List 







304 (130) 
PDNM (cont. ) 
Procedure DD Name 








312 (138) 






PSNM (cont. ) 
Procedure Step Name 







320 (140) 





RDNM (cont. ) 
Reader DD Name 









328 (148) 
RSNM (cont. ) 
Reader Step Name 








336 (150) 





PPSN (cont. ) 
Previous Procedure Step Name 








344 (158) 











ORIDSNM (cont. ) 
Name of Next Procedure Step Overriden 











352 (160) 






RELPROC 
Address of PROC Referback Dictionary 


IWAPARM 


Address of Parameter List for Processing In-Stream Procedures 







360 (168)| 






DSENQTP 
Address of DSENQ Table 


RELPGM 
Address of PGM Referback Dictionary 





368 (170) | 176 
* SREFB 
Referback Dictionary (Input) 


544 
a DREFB 
Referback Dictionary (Search) 
720 
ICT 
Job Control Table (JCT) 
ove JBCONCAT !} twAsBROL '} — crswi | 


| SCTCNT 
No. of SCTs 


No. of Rollin/Rollout | Ckpt/Restrt Soh SY MTTR 
JOBLIB SIOTS Param Switches B ymbolic Parameter Address 





Figure 23. Interpreter Work Area (IWA) (Part 2 of 4) 
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904 (388) 


912 (390) 


IWAJ OBS 1 
Calling Stepname for Checkpoint/Restart 


IWAJ OBS3 


Procedure Stepname for Checkpoint/Restart 


920 (398) 
IWAJOBS5 
SYSCHK DD Statement Address 


928 (3A0) IWAWKBF 


Address of Work Area Gotten When 
First In-Stream Proc. Encountered 


936 (3A8)1  wavo_tt | IWABSAM 


(cont. ) Addr. of BSAM Access Method 
VOLT Length for In-Stream Proc. Processing 


944 (3B0) 


DRNT 
DD Name Reference Table 


1024 (400) 


IWAJOBS6 
Job Statement Region Size 


IWAVOLTB 
Queue Address of VOLT 
DDINO | 
DD Internal 
Number 


DDSWX! 
Switch XI 


Reserved 


Step Control Table (SCT) . 


1200 (4B0) 


System Message Block (SMB) 


1376 (560) 


DSNAME 


Data Set Name Table (DSNAME) 


1552 (610) 


VOLT 


Volume Serial Table (VOLT) 


1728 (6CO0) 
IWASTPSO 
Track Stack Work Space 


1736 (6E0) 


Figure 23. 
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Reserved 


IWASTPS8 
Checkpoint/Restart Reinterpretation of JCL (MVT) 


Interpreter Work Area (IWA) (Part 3 of 4) 


IWAVOLTL 

















Job 


Information 


Step 


Information 


1768 (6E8) 1 swz 1 
SWY 


Scan Switches 


IWARET 
Return Codes 


Cont. and Scan 


Joint Switches 
Reserved 





1792 (700) 176 


TEXTBUF 
Intermediate Text Buffer 


» 1968 (7B0) 
TBEGP TKEYP 


Text Begin Address Text Key Address 


1976 (7B8) 
TNUMP TLENP 
Text Number Address Text Length Address Statement 


Information 


1984 (7CO) 
TENDP -CURLE LASLE 
Text End Address Current Level Last Level 


1992 (7C8) 
SAVEPTR CTRLWAP 
Current Register Save Area Control Routine Work Area 


2000 (7DO) 
DEBUG IWASTMSO 
DCB Address Reserved 


2008 (7D8) SWY2 
IWASTMS 1 IWASTMS2 rere ee 


SYSIN Address During Rollout Reserved Switches 


2016 (7EO) 


Reserved 


2024 (7E8) 
IWASTMS5 IWANELJC 
Reserved NEL JCL Address - Input to Post Scan Routine 


2032 (7FO) ] ] ] ] 1 1 
IWASTMS7 IWANELEN IWAPCV IWAJDALL IWAJDICL IWAMS LEN IWAMCSCA Task 


Reserved NEL Length Switch K Switch L Switch M Switch N MCS Command Authority Information 


2040 (7F8) 
IWACONID 
MCS Console !D Address 


Reserved 





Figure 23. Interpreter Work Area (IWA) (Part 4 of 4) 
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JOB CONTROL TABLE (JCT) 


Description: The job control table (JCT) (Figure 24) is created in the interpreter work. 
area by the joo statement processor routine of the interpreter. It contains information Ras, 
from the JOB statement, job status information, and pointers to other tables in the job's 

input queue entry. When the interpreter has processed all steps of a job, the Jct is 

written into the appropriate input queue according to priority; it is read back into main 
storage by the initiator job selection and job delete routines. 


Although most of the fields in the job control table are self-explanatory, the 
following require further description: 


e Job Status Indicators: The sixth byte of the JCT indicates the status of the job as. 


ee mptceren eS <paemerrm RTE RREN ENM Nifee em ENGNG ome see Movers rakianer tata 


shown pelow: 


Bit Setting Meaning 
A JOBLIB DD statement is included with the job 
Job flush 
Job step canceled by condition codes 
Step flush 
JCT ABEND 
Job failed 
Job includes a cataloged procedure 
Job is a "no setup" job 


0 
a 
2 
3 
mM 
5 
6 


PRR ER ee 


7 


e Additional Job Status Indicators: The byte indicates the status of the job as 
follows: Bit O is set to 1 to indicate spooled SYSIN data for the job. Bits 1 
through 7 are reserved. 


e Checkpoint/Restart Indicators: This two byte field indicates the checkpoint/restart 
Status as shown below: 


Byte 1 

Bit Setting Meaning 
0 1 Warm start 
1 Not used by MFT 
2 Not used 
3 1 Checkpoint taken for this step 
4 1 Intra-step checkpoint/restart to be done 
5 1 Step restart to be done 
6-7 0 Must be set to zero 

Byte 2 

Bit Setting Meaning 

1 SYSCHK DD statement is included with the job 
1 1 RD keyword parameter is not NC 
2 1 No restart is to be done 
3 1 No checkpoints are to be taken 
4 1 Do restart if necessary 
5 1 Direct SYSOUT writer active at checkpoint 
6 1 Job is eligible for direct SYSOUIr facilities. 
7 1 DSDR processing has not successfully ended 
e SYSOUT Classes: The first 36 bits of the five-byte field are used to indicate the | ~ 


system output classes that contain data. The four remaining bits are reserved. 


Mapping Macro Instruction: IEFAJCTB 
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(ee) 


AE 


24 


40 


48 


56 


88 


104 


112 


128 


136 


144 


152 


160 








| | Internal Job Message Message 
Address in Queue of JCT | Table ID =00 | Job Serial Status Class bevel ond 
Number Indicators Job Priority 


Job Name 


Teleprocessing Terminal Name 


| 1 
Add inQ f GDG 
Address in Queve of PDQ Saas Table. : Reserved 
1 
Address in Queue of First SCT Reserved Address in Queue of First SMB Reserved 
1 
Address in Queue of Job ACT Reserved Address in Queue of First SCD Reserved 
1 
Address in Queue of Last DSB Reserved Key of SMB Track First Job Condition Code 
] 


First job 
Condition Reserved 
Operator 





Reserved for Seven Additional Job Condition Codes and Operators 


Checkpoint/ 
Restart 
Indicators 


Queue 


TTR of DSENQ Table Region Parameter Ident. 
(MVT Only) (MYT Only) (MVT Only) 


R of C d 
ne Only) ter Checkpoint Data Set Device Type 


3| No. of Job . Velncok 
TTR of JFCB for Tracks on Number of Checkpoint 


Checkpoint Data Set SYST .JOBQE Checkpoints 
p (MVT oly) p Data Set 


Reserved 


4) Additional 


TTR of SCT for First Step to Run Job Status Length of 
Indicators Chkpt ID 


Checkpoint ID (left Justified, from 1 - 16 bytes) 


Queue Address of JMR 


JMR Address Date 
(Cont'd. ) Difference 


SMF Options Cancel Flags Job Time Limit Step Start Time 
Step Start Time (Cont'd. ) Job Start Time Job Start Date 


Address in Queue of First SMB 
SYSOUT Classes for Direct Sysout Processing 


Reserved 





Figure 24. Job Control Table (JCT) 
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JOB FILE CONTROL BLOCK (JFCB) AND EXTENSION (JFCBX) 


Description: A job file control block (JFCB) (Figure 25) is constructed in subpool zero 
(from information ina DD statement) by the interpreter DD statement processor routine. 

the JFCB is written into the job's input queue entry, and retrieved when a DCB with the 

corresponding name is opened. The information in the JFCB, which describes the 


characteristics of a data set, may be modified by the open routine. 


A JFCE contains enough space to record five volume serials. If more than five volume 
serials are specified, enough job file control block extensions (JFCBXs) to contain the 
additional volume serials are constructed; each JFCBX can contain up to fifteen 
additional volume serials. 


Additional information on the contents of the JFCB and JFCBX may be found in the 
publication, IBM System/360 Operating System: System Control Blocks, GC28-6628. 


Mapping Macro instruction: IEFUFCBN 


LIFE-OF-TASK (LOT) BLOCK 


Description: The 384-byte life-of-task (LOT) block (Figure 26) is built in a main 
storage area optained from subpool 253. It contains information for scheduling 
functions, and is used by system task control and initiators. It is created by the Job 
Select module for initiating problem programs. 


The LOT block contains the linkage control table (LCT), a two-level register save area 
(REGSAVE), an input queue manager parameter area (QMGR1), an output queue manager 
parameter area (QMGR2), the address of the ECB list, the address of the PIB, the address 
of the SPIL, and the ECB List. 


LINKAGE CONTROL TABLE (LCT) 


Description: The linkage control table (LCT) (Figure 27) is part of the LOT block 
constructed by the Job Select module in subpool 253. It is also built separately by 
System Task Control, in which case its storage is obtained from subpool zero. It isa 
communications area used by the routines of the Initiator, System Task Control, 
Allocation, and Termination. 


Most of the fields in the LCT are self-explanatory; it should be noted, however, that 
the job termination status bit is the low-order bit of the one-byte device features 
field. | 


Mapping Macro Instruction: IEFALLCT 
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Data Set Name 





Element Name or Relative Generation Number 





48 (30) I 
Element Name or Relative J/M +D/M 
Generation Number (continued) Interface 
56 (38) 
Reserved 
= 
l 2 
Label Type Buffer File Sequence Number | Volume Sequence Number 
O ffset 
72 (48) 
Data Management Mask 
80 (50) 
Data Set Creation Date Indicator Indicator 
Byte | Byte 2 
88 (58) Sie eee ee 1 ; Device 
of Tech ae Buffer Length ae Character- ne Reserved 
Buffers niqu ptions istics ensity 
96 (60) 
Reserved Data Set Organization laa Maxim Blécle Size 
104 (68) 
Number of | Number of Relative Location 
Logical Record Length | Channel Master of Key in Logical: RED Reserved 
Programs Index Tracks 
112 (70) | i 
Number of | Number of 
Reserved Overflow Volume 
Tracks Serials 
First Five Volume Serials 
l 
pe a Queue Address of First JFCBX 
152 (98) 1 
Space indians 
Primary Quantity Type Secondary Quantity 5 — ra 
Requested ae 
A 
eyes ' Relative Address 
Baton <Qucent Main Storage Address of of First Track 
irectory Quantity . , . 
Split Cylinder JFCB i Aliiecced 
168 (A8) i ; 
Main Storage Address Volume Number of 
of SUBALLOC JFCB Average Data Record Length Cait Tracks per 
Cylinder 
176 (BO) : 
= Job File Control Block 
0 (0) 
e Queue Address of Next JFCBX Reserved 


15 Additional Volume Serials 





96 (60) 


Reserved 


76 ©. Job File Control Block Extension 





Figure 25. Job File Control Block (JFCB) and Extension (JFCBX) 
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Linkage Control Table 


104 (68) | | 72 


Register Save Area | 








176 (BO) 
Register Save Area 2 
248 (F8) 
Input Queve Manager Parameter Area 
36 
284 (11C) 
Output Queve Manager Parameter Area 
320 (140) } - 1 
Number of Stack Address Queue Breaking Information 
Buffers 
328 (148) 
Address of ECB List Address of PIB 
336 (150) 
Address of SPIL 
ECBLIST Used to Dequeue Jobs 
376 178 


Reserved 


Figure 26. Life-of-Task (LOT) Block 
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& 


ls Address of Job Step CSCB 







8 (8) 
TCB Address 
16 (10) 
JCT Address 
< 24 (18) 
Queue Address of Current SCT 
32 (20) 
* Error Code 
56 (38) JFCB I 
; Current Step 
Reserved Housekeeping 
. Number 
Indicators 
64 (40) 
Counter for Assigning Unique Volume 
Serials to Passed Data Set Volumes 
72 (48) 
Return Address to System Task Control Routine 
96 (60) 


JOBLIB DCB Address 


Figure 27. Linkage Control Table (LCT) 





Action Code 






Address of I/O Supervisor UCB Lookup Table 






Device 
Features 





Linkor's Register Save Area Address 


SCT Address 


Allocate/IEFVPOST Communication Block Address 


Communications Area 


Address of Register 
Save Area for 
Allocation and Termination 


Address of Current SMB 


Address of Message Class QMPA 


Initiator 
Internal 


Switches (MVT) 


PARM Field Address (MVT) 


Timer Work Area 


Allocate/Terminate Parameter List Address 
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MASTER SCHEDULER RESIDENT DATA AREA 


Description: The master scheduler resident data area (Figure 28), which is in the 
nucleus area of main storage, contains information used by the queue initialization, 
command scheduling, initiator, and I/O device allocation routines. its location is 
stored in the CVIMSER field of the communication vector table. 


Most of the fields in the master scheduler resident data area are self-explanatory; 


those fields that require further explanation are described below: 


84 


wueue Formatting Switch: If the high-order bit of this field is on, it indicates 
that the queue data set must be formatted. 


Transient Reader TTK: This field is used by the transient reader suspend routine to 


store the address of the work queue data set where the reader information was placed 
when the reader was suspended. 


DEFINE Control Information: If the high-order bit of this field is on, it is a 
DEFINE operation; if off, it is IPL time. The second bit indicates that a list of 
the partitions" sizes and job class(es) has been requested; the third bit indicates 
that there is an adjacent partition check; the fourth bit is set when initialization 
is complete to allow DEFINE commands to be accepted; the fifth bit is set on when the 
Operator has requested partition changes at IPL; the sixth bit indicates that a small 
partition cannot terminate because of the DEFINE operation; the seventh bit indicates 
that a DEFINE command has been issued during operation; the eighth bit indicates that 
the system has storage protection. 
Status Flags: When set on, status flags indicate: 

Bit Meaning 
0 System Initialization in prdgress 
A -? MONITOR JOBNAMES 
2 Reserved 
3 VARY/UNLOAD summary 
4 Queue holid-release 
5 DISPLAY ACTIVE processing 
6-7 Reserved 


es EL EN LR SR ED ER a aS 


Bit Meani ng 
0 Log Data Set Sysout Scheduling 


1 Log Threshold Reached 


MFT Switches: When set on, flags indicate: 
Bit Meani ng 
0 Transient Reader Active 
1 Transient Reader in Core 
2 Pending START command for transient reader 
3 MFT Environment switch 
4 System Assigned Reader is Running 
5 Core storage is in System 


e Initialization Switches: When set on, flags indicate: 


LOS ES SE LS NE A IT NS TS ON SOLE RO 


Bit Meaning 
0 IPL switch 
1 SYSOUT IPL 
2 SYSOUT job start 
3-4 Reserved 
5 34 Security 
6 Queue initialized 
7 Procedure catalog initialized 
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e System Exclusive Switches: When set on, switches indicate: 


dt 


B 
0 
1 
2 
3 
mM 
5 


e Pending Flags: 


Bre 


SIO UF W NR OlF: 


Meaning 

Console flag (PCP only) 

CANCEL flag for ABEND (PCP only) 
Roll-out flag (PCP only) 

Spinoff flag (PCP only) 

MONITOR data set name 

MONITOR space 


When set on, flags indicate: 


Meaning 

IPL Date 

Region busy 

Command move completed 

Interpreter command return 

System Input control purge request 

System output control purge request 

Blank start pending (REQ=1,START BLANK=0) 

Console command suppressed by WTO/WfOR Exit Routine 


e ECB Flags: When set on, flags indicate: 


Bit 


WOOF WNHF Ol: 


w 
> 
cr 


“J NUEWNE S| 


e Fetch Flags: 


to 
fale 
cr 


NOUEWREO 


Meaning 
External interrupt 

WTO or WIOR 

WIL 

Console Attention key hit 

system [fnput 

system Output 

Master command routine 

Summary bit, Vary UCB scan required 


-@ Resident Switches: When set on, switches indicated: 


Meaning 

IPL has been completed 

WIO or WTOR pending 

Console usage, Primary or alternate 

Log purge request 

Reader has reached end of file, or Start reader 
New reader pending 

New writer pending 

New writer pending (Modify) 

Job notification (1=yes) 


When set on, flags indicate: 


Meaning 

Named Fetch | 
Defer current command execution sequence 
TCB Tree Trace Fetch (Locate) 

Auxiliary FETCH given 

Reply bit to Request attention 
Pseudo-SYSOUT flag 

MONITOR STATUS 

Queue hold-release 


e Mapping Macro Instruction: IEEBASEB. 
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0 (0) 
8 (8) 
16 (10) 
24 (18) 
32 (20) 
40 (28) 
48 (30) 
96 (60) 
104 = (68) 
112 (70) 
120 (78) 
128 (80) 
Figure 


Address of CSCB Chain 


Master Scheduler ECB 


Address of Job Queve UCB 


sueve ; Address of Set Auto 
coumalriag Command Parameter List 
Switch 

Number 

of Tracks 

in Initiator 


Stack 


Interpreter Counter 


Minimum Problem Log Status 


R 
Program Partition Size Flags eeeived 


Reserved 


Core Storage High Boundary for Hierarchy 0 


Low Boundary Pointer 


Transient Reader, Pending CSCB Pointer 


Transient Reader TTR 


Reserved 





Group Queue Pointer 
(MVT only) 


Communications Task IPL ECB 


Address of PROCLIB UCB 


Address of System Log Control Table 


Minimum Initiator 
Partition Size 


Initiator 
Protection Key Mask 


System Log ECB 


ID of eontele 
that entered 
DEFINE 


Reserved 


First FQE Pointer 
for Subpool 255 


High Boundary Pointer 


MFT 
Switches 


Transient Reader CSCB Pointer MFT 
Area 


DEFINE Control! Information 


Address of ECB Chain for Readers 


8. Master Scheduler Resident Data Area (Part 1 of 2) 
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i 136 88 | | ' 
A (88) Initialization ayste Pending Resident Command 
a Switch Exclusive Flaas Switches We 
; Switches g Status Flags 
144 = (90) Variable 
Command Verb (cont.) Communication 
. Field 
152 = (98) Msg. 
Variable Communication Field (cont.) Generation 
Control 
4 160 (AO) : ie 
ointer to Character Co 
Before List Master ECB oe 
168  (A8) 
. Pointer to ECB in SJQ Entry of , 
| Non (Uciaa Consale ECB for Allocation 
176 (BO) 
Pointer to Pointer to 
Primary UCB Alternate UCB 
184  (B8) 
Pointer to Reserved 
Pseudo=Disable Switch 
192 (CO) 


Reserved 





Figure 28. Master Scheduler Resident Data Area (Part 2 of 2) 


PARTITION INFORMATION BLOCK 


The 48-byte partition information block (PIB) (Figure 29) contains information used by 
the command processing and scheduler routines. Its location is stored in the TCBPIB 
field at displacement 124 (decimal) of the task control plock (TCB). 


Although most of the fields in the partition information block are self-explanatory, 
the following require further description: 


e ECB Address: Contains the address of ECB to be posted by job selection when the 
partition is made quiescent for partition redefinition. 


e "No Work" ECB for the Initiator: This ECB is posted by small partitions requesting 


service, the queue manager when a job has been enqueued, and by the DEFINE and START 
command routines. | 


e Status A Information: 


Bit Setting Meaning 

; 0 Stop initiator 
: 1 START INIT issued 

1 1 Partition active 

2 1 Reserved 

3 1 Transient reader is suspended 

4 1 Partition is to be terminated by IEFSD599 when it next gets 

control 

5 1 Partition is involved in redefinition 

6 1 System-assigned transient reader operating in this partition 

7 1 Problem program is running 
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e Status B Information: 


88 


Bit Setting Meaning 
Logical tracks added for initiator 
LOT block exits 

SPIL has been created 

Reserved 

Unending task present in partition 
JOBLIS Switch 

SFEPLIB Switch 

FETCHLIB Switch 


BRE RR RR 


0 
1 
2 
3 
u 
5 
6 
7 


SPIL Address: The small partition information list (SPIL) is applicable to large 
partitions only. 





Job Class Codes: Contains one to three codes for the partition, arranged in 
descending numerical order, i.e., GRP3 is in the second byte of the field, followed 
by GRP2 and GRP1. ‘the first byte contains the protection key for the partition, if 
the system has the storage protection feature. 


ee ED Se TET ce RENTON NRETEN Rare AL A ES ee NOY CO ES RN CI TNS INN rE te 


Bit Setting Meaning | 
0 1 A large partition in which the DSDR processing step for a 
small partition (less than 12K) is to be executed 
1 1 Reserved ; 
2 1 A DEFINE command has been received and the partition is 
processing jobds on its internal queue. 


3-7 Reserved 


ae rea eee ere soe re ce err meeciner ererraieematein eee semen 


Bit Setting Meaning 
0 1 The job step TQE is being used for job step timing. 
1 1 Indicates to the Initiator that the step being terminated 
was timed. 
2-7 Reserved. 
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te CSCB Address of Pending Command 
































4 (A) 
ECB Address 
8 (8) 
"No Work" ECB for the Initiator 
12. (C) 
Status Bits- A Address of Current Job Step CSCB 
~ 16 (10) 
Status Bits-B SPIL Address 
20 (14) 
CSCB Address of Current Task in Partition 
24 = =(18) 
Protection Key Job Class Codes 
28: .(1C) 
CSCB Address of Suspended Reader 
32. (20) 
Address of the Direct SYSOUT Control Block (DSOCB) Chain 
36 = (24) 
fe Internal Queue Address of Internal Queue of Job Names to be Restarted 
[. Status Bits 
a 
AO = (28) 
Job Step Timing Address of the Job Step TQE 
Status Bits 
44. (2C 
eo) ae of Address of the RB of the Most 
ees Recently Loaded Module on the JPAQ 
Subtasks 
Figure 29. Partition Information Block (PIB) 





Appendix A: Tables and Work Areas 89 


SMALL PARTITION INFORMATION LIST (SPIL) 


Description: The 80-byte small partition information list (SPIL) (Figure 30) is a 


storage area for information pertaining to small partition scheduling. It is built in 
main storage obtained from subpool 0. the address of the ECBs provides for information 


to be passed between the small partition and the large partition that is performing 


initiation, allocation, or termination functions for the small partition. 


Most of the fields in the small partition information block are self explanatory; 


however, the status bits field is described below. 


Bits 0 and i contain ones if a START writer or reader command has been entered. 


Bit 2 contains a one if a SPIL pointer has been stored in the PIB. 
Bit 3 contains a one if a problem program has requested termination. 
Bit 4 contains a one if an indicative dump was requested. 


Bits 0-7 contain zeros if a START INIT command was entered. 





0 (0) 
(ECBA) 
Event Control! Block 
4 (A) 
(ECBB) 
Event Control Block 
8 (8) 
(ECBC) 
Event Contro! Block 
12 (C) 
Address of Small Partition TCB 
16 = (10) 
Status Bits | Reserved 
20 =(14) 
Address of Allocate Parameter List (In Large Partition) if a Problem Program; 
TIOT, if a Reader or Writer 
24 (18) 
Address of CSCB for Writer 
28 (1C) 
ECB List for DEQUEUE 
68 (44) 
Address of LINK Parameter List (In Large Partition) 
72 ~~‘ (48) 
Address of 3- Word Parameter List for IEESD590 and IEESD591 
76 =(4C) 


Step Time Remaining for Problem Program Executing in a Small Partition 


Figure 30. Small Partition Information List (SPIL) 
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‘ Wl 
. fy ii) 
a 


STEP CONTROL TABLE (SCT) 


Description: The step control table (SCT) (Figure 31), is used to pass control 
information to the DD routine of the interpreter and to the initiator routines, which 
also contribute information to the table. This table is created and initialized by the 
execute statement processor routine of the interpreter when an EXEC statement is read. 
One SCT is created for each step of a job. 


If the step is part of a previously cataloged procedure, the name of the step that 
called the procedure, if any, is entered. The following variable-content and indicator 
fields are included in the table: 


BYTE 4: Internal Step Status indicators: 


Bit Setting Meaning 

0 Step can be rolled out 
Roll step out if necessary 
Do not restart step 
Do not take a checkpoint 
Restart if necessary 
Graphics - alter protect key 
Graphics - ABEND exit 
Step failed 


NOU EWN 
PERE RP PPP 


PARM Count or Step Status Code: 


a. Interpreter: The number of characters specified in the PARM parameter of the 


EXEC statement is placed in this entry. 


b. Initiator: This table entry contains the condition code returned by the 
processing program. 


BYTE 67: Step Type Indicators: 


Bit Setting Meaning 

EXEC statement contains PGM=*.stepname.ddname 
SYSIN is specified as DD* 

SYSOUT is specified 

JFCB housekeeping is complete 

Initiator Indicator 

Reserved 


£ 
1 WwnRro 

On 
PRR 


BYTE 104:. Extension of Internal Step Status Indicator 


Bit Setting Meaning 
0 Reserved 
1 


1 Direct system output facilities required to output job 
separator or system messages. 
2 1 Allocation for control volume 
3 Reserved 
4 1 STEPLIB present 
5 1 Spooled SYSIN for step 
6 1 Job ended 
7 Reserved . 


Mapping Macxo Instruction: IEFASCTB 


Appendix A: Tables and Work Areas 


91 


24 


32 


40 


48 


56 


64 


72 


80 


88 


96 


104 


112 


120 


160 


168 


176 


(18) 


(20) 


(28) 


(30) 


(38) 


(40) 


(48) 


(60) 


(68) 


(70) 


(78) 


(AO) 


(A8) 


(BO) 


















Internal 
Step Status 
Indicators 





Maximum Step Running Time 


] 
1 ] 
Reserved Queve Address of Next SCT Reserved 
1 
Reserved 
1 
Reserved 
1 
Reserved 
8 


Name of Step That Called Procedure (Continued) 


] 
Table ID 
Queue Address of SCT. “(02) 
2 


Length of Allocate Work 
Area, or Number of SIOTs 







2 
PARM Count or Step Status 
Code at Termination 












Queue Address of First SIOT Entry 






Queue Address of Allocate Work Area 



















Queue Address of Last SMB 
for This Step 


Queue Address of First SMB 
for Next Step 








Queue Address of First ACT Entry 
for This Step 





Queue Address of VOLT 


1 


Name of Step That Called Procedure 













Queue Address of Dsname Table 
for This Step 





Step Name 













Relative Pointer to 


Step Entry in ACT 






Step Name (Continued) Length of VOLT 














Number of 
JFCBs to 
Allocate 


Number of | 
Setup 
Messages 


Number of ! 
SIOTs in 
This Step 






Step Type 
Indicators 












Queue Address of SCTX 












Hierarchy 1] 
Region Address 


Hierarchy 0 


m0 Region Address 





Queue Address of Checkpoint 
Restart First WTP SMB 


Reserved 













Step Dispatching 
Priority 
(MVT only) 






Hierarchy ] 
Region Size 


Hierarchy 0 
Region Size 











Queue Address of PGM = *, 
stepname, ddname SIOT 





Step SYSIN count for SMF 












Extension I 














of Internal Queue Address of p N 
Step Status the Step TIOT ea 
Indicators 







Length (in Bytes) of 
Dsname Table for This Step 











Program Name (Continued) First Step Condition Code 


36 







First Step 
Condition 
Operator 





Queue Address of First Condition SCT 


Second Through Seventh Step Condition Entries 


: ] 2 
- Eighth Step 
Eighth Step Condition Code Condition Queue Address of Eighth Condition SCT Reserved 
Operator 
3 


Number of 1 


Queue Address of the First Message Step Queue Address of 


DSB in Message Class Class DSBs Status Last Legitimate SMB 
for this Step 





Figure 31. Step Control Table (SCT) 
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3 ] 
i Reserved ; 


STEP INPUT/OUTPUT TABLE (SIOT) 


£ Description: The Step Input/Output Table (SIOT) (Figure 32), makes DD statement 

% available to the initiator for use as a source of information for the TIOT and for 
providing DD information to allocation and disposition routines. When a DD statement is 
read, the interpreter creates a new SIOT and places the DD information into it. the 
individual bits of the disposition byte and of indicator bytes 56 through 59 in the SIOT 
are set to one to indicate the following conditions: 


Bit Meaning 
Reserved 
Retain volume 
Private volume 
Pass data set 
Keep data set 
Delete data set 
Catalog data set 


Uncatalog data set 


WO OO FWNH FE Ol 


BYTE 56: Indicator Byte Number 1 
Bit Meaning 
Dummy data set 
SYSIN data set 
Split (primary) 
Split (secondary) 
Suballocate 
Parallel mount 
Unit affinity 
Unit separation 


NNO FWHE OF: 


BYTE 57: Indicator Byte Number 2 
Bit Meaning 

Channel affinity 
Channel separation 
Volume affinity 
JOBLIB DD statement 
Unlabeled (no labels) 
Pool DD statement 
Defer mounting 
Received data set 


WO UW SWNHF OlF: 


BYTE 58: Indicator Byte Number 3 
Bit Meaning 

Volume reference 

SYSIN expected (procedures only) 

Allocate work table volume block indicator 

Volume reference in step 

SYSOUT was specified 

NEW data set 

MOD data set 

OLD or SHR data set 


SOU EF WDH PF O|F: 





Appendix A: Tables and Work Areas 93 


BYTE 59: Indicator Byte Number 4 


Bit Meaning 

Set by reader to indicate GDG single 

Set by initiator to indicate GDG all 

Volume serial number was found in passed data set queue (PDQ) 
American National Standard label 

Step processed 

Intra-step volume affinity 

Data set is in PDQ 

1 old or modified data set 

0 new data set 


NAME WHF OO 


BYTE 92: Conditional Disposition 
Bit Meaning 
0-3 Reserved 
Keep data set 
Delete data set 
Catalog data set 
Uncatalog data set 


NOW 


Mapping Macro Instruction: IEFASIOT 


TASK INPUT/OUTPUT TABLE (TIOT) 


Description: The Task Input/Output Table (TIOT) (Figure 33) provides data management 
routines with the addresses of the JFCBs and devices allocated to the data sets in a job 
step or system task. It is constructed by the I/O device allocation routine in main 
storage. the allocation routine also places a copy of the TIOT on the appropriate job 
class queue with the other tables for the job step. After the step completes processing, 
the TIOT is brought in from the job queue and placed in the upper portion of the 
partition. The step is then terminated, and the TIOT is deleted. 


For further information on the TIOT, see IBM System/360 Operating System: System 
Control Blocks, GC28-6628. 
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20 


28 


36 


44 


52 


60 


68 


76 


84 


92 


124 


132 


(24) 


(2C) 


(34) 


(3C) 


(54) 


(SC) 


(7C) 


(84) 


Queue Address of SIOT Table ID 





DD Name 










Channel Separation and Affinity 


Unit Separation and Affinity 








Queue Address of Next SIOT Queue Address of JFCB Reserved 





Reserved 










Queue Address of SIOT 
for VOLREF or SUBALLOC 


Queue Address of SIOT System 
Output/Dependency Block 






Reserved Reserved 





























3 ] ] 
TSO and TCAM omer ot Relative Pointer to 
Reserved fadiediars Reserved Volumes in 
Volume Table Entry 
(MVT Only) VOLT 







Number of 
Units for 
This Data Set 























Volume 
Count 


Internal 


DD Number Indicator Bytes 


Disposition 


Unit Type 


System Output Program Name 


1 






DD Statement 
Duplicate 
Number 








System Output Form Number Reserved 








Queue Address of Next DSB 
if SYSOUT Specified 






Queue Address of the DSB for this Data 
Set if SYSOUT Specified 





Reserved 











TTR of SIOT 
being passed 


Conditional 
Disposition 


Reserved 


& NAME from DSNAME = 
for Dedicated Work Files 


& NAME from DSNAME = for Dedicated Work Files 
(Continued) 


DCB Reference Name 





Figure 32. Step Input/Output Table (SIOT) 
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Job Name 
8 (8) 
Step Name 
16 (10) 
Name of Step Calling Procedure, or Zeros 
24 (18) 
Status Allocation 
Bits Data 
32 (20) | First 
Address in Queue of Status 
DD Name (continued) : DD 
JFCB or SIOT Bits Entry 
40 (28) | —T 


Status Address of UCB Status _ Address of UCB Device 
Bits or Link Value Bits or Link Value Entries 





Zeros ~ End of TIOT 


Figure 33. Task Input/Output Table (TIOT) 


WRITE-1O-PROGRAMMER CONTROL BLOCK (WTPCB) 


Description: fhe write-to-programmer control block (WTPCB) (Figure 34) is built by 
allocation interface control routine IEEVACTL in the system queue area. It is used by 
system tasks and problem program tasks when write-to-programmer messages are issued. The 
"Flags" field is defined below: 


\cr 


Setting Meaning 

Job queue problem 

Limit message processed 

Step contains SYSOUT 

Return to IEFWIPO1 upon completion 

No record message processed 

Last SMB used for job 

WrP invoked for this step 

WIOR or WIO with additional routing codes being processed by 
WTP 


to 
SG GuGuiemuega ee: 
fea pS pd ba pd pd pr po 


TTR Being Used by WTP 


Address of Message Class QMPA 








TTR of First WTP SMB in Step Remaining 
(Needed for Checkpoint/Restart ) Bytes in SMB 


Number of 
WTP's issued, Number of Reserved SMBs for WTP. 





Figure 34. Write-to-Programmer Control Block (WIPCB) 
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APPENDIX B: MFT MODULES 


This appendix contains a table of unique MFT job management modules, a group of tables 
Showing the modules of each major component, a list matching entry point and control 
section names with source module names, and a brief description of each of the modules 
used by the MFI level of job management. If you are looking for a specific module and 
know only the major component and routine name, use Figures 36-46 which give a 

- cross-reference to the source module. The source modules are in turn listed 
alphamerically for easy access. If you know the source module name, go directly to the 
module descriptions. 


Unique MFT Modules 


Figure 35 lists all modules that are unique to the MFT level of job management. This 
table is organized by major component. 


Figure 35. 





MFT Modules 


Initiator: Master Scheduler Task: SVC 34: 
LEFPPGM TEECIR50 TEESD561 
TEFSD167 TEECIR51 TEESD571 
LEFSD320 TEEDFINA IEESD671 
TEFSD330Q TEEDFINB TEE2803D 
LEFSD510 IFEDFINC TEE3903D 
TEFSD511 TEEDFIN1 TEE7903D 
LEFSD512 TEEDFIN2 
LEFSD513 TEEDFIN3 
LEFSD515 TEEDFIN4 
IEFSD516 LEEDFINS System Management Facility: 
TEFSD517 TEEDFING6 eS a 
TEFSD518 TEEDFIN7 ITEESMFWT 
LEFSD519 TEEDFIN8 
LEFSD540 ITEEDFIN9 
ITEFSD541 LTEESD566 
LEFSD553 TEFSD569 
TEFSD554 System Task Control: 
TEFSD555 Nucleus: eee ae et ee ee 
LEFSD556 —S a ae TEESD590 
TEFSD558 ITEESD568 IEESD591 
LEFSD559 TEFSD567 TEESD592 
LEFSD598 IEEVACTL 
LEFSD599 TEEVOMSG 
Queue Management: LEEVSMBA 
LEFSD572 cae 
LTEFSD535 
_Reader /Interpreter: IEFSD584 
oe LEFSD530 ITEFSD585 
1/0 Device Allocation: LEFSD531 LEFSD586 
TEFSD551 LEFSD5 32 TEFSD587 
LEFSD552 LEFSD5 33 TEFSD588 
LEFSD557 TEFSD5 36 TEFSD589 
TEF41DUM LEFSD5 37 TEF589SP 


Appendix B: 


MFT Modules 


Major Component Modules 


Figures 36 through 46 list all MFT job management modules according to major component. 
The figures appear in alphabetical order by component name. Within each component, 
routine names are listed alphabetically with a cross-reference to the module name. 
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Figure 37. 


Routine 


Initialization 

Release DSOCB Routine 

SIOT and JFCB Modification 

STOP and MODIFY Command 
Processor 

System Messages and Job 
Separator Writer 

Tape to Printer or Card 
Punch 


Direct System Output 


Routine 


Alternate Step Deletion 

Data Set Integrity 

Dequeue by Jobname 
Interface 

Dummy User Job Initiation 
Exit Routine 

Dummy User Step Initiation 
Exit Routine 

ENO/DEQ Purge 

Job Deletion 

Job Initiation 

Job Selection 

Job Suspension 

Linkage from Job 
Termination to Initiator 
for the 30K Scheduler 

Linkage from Job 
Termination to Initiator 
for the 44K Scheduler 

Linkage to IEFSD168 

Linkage to IEFSD510 

Linkage to IEFSD511 

Linkage to IEFSD512 

Linkage to IEFSD515 

Linkage to IEFSD516 

Linkage to IEFSD541 

Partition Recovery 

Problem Program 
Initialization 

Problem Program Interface 

Problem Program Table 

Set Problem Program State 

Shared DASD ENQ/DEQ Purge 

Small Partition Module 

Step Deletjon 

Step Initiation 

TCTIOT Construction 

User Exit Initialization 
Routine 


SS ES SD ED GE AOE AE GORE GED CUED ONT GED ERED QUEED GID GED GENE cD OURS ante GEE ee eS OE wens ae eee eee ee 


Initiator Modules 


b—————— —— —+——4 


be YH 


Source 
Module 


IEF DSOCP 
Te#FDSOFB 
IEF DSOAL 
ITEFDSOSM 
ITEFDSOWR 


ITEF PRINT 


Modules 


Source 
Module 


ITEFSD516 
TEFSD541 


TEFSD519 
IEFUJI 


TEFUSI 

ITEFSD598 
ITEFSD517 
ITEFSD511 
ITEFSD510 
IEFSD168 


ITEFSD330Q 


IEFSD32Q 
IEFSD167 
IEFSD555 
IEFSD558 
IT@FSD553 
IEFSD559 
ITEFSD554 
IEFSD540 
ITEFSD518 


IEF PPGM 
IEFSD513 
ITEFSDPPT 
IEFSD556 
IEFSD597 
IEFSD599 
IEFSD515 
IEFSD512 
LTEFSMFAT 


ITEFSMFIE 


| 
| 
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| 
| 
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Figure 38. 


Routine 


Control 
Entry 
Exit 
Recovery 
Recovery 


Allocation 

Allocation 

Allocation 

Allocation 

Allocation 
Messages 

Automatic Volume 
Recognition 

Automatic Volume 
Recognition Messages 

Automatic Volume 

Recognition Non-Standard 
Label koutine 

Automatic Volume 
Recognition Label 
Processing 

Automatic Volume 
Recognition Tape 
Processing 

Bit Pattern Scan Routine 

DADSM Error Recovery 

Decision Allocation 

Demand Allocation 

Device Bit Pattern 

Device End Interrupt 
Handler 

Device Strikeout 

EXEC Statement Condition 
Code Processor 

EXEC Statement Condition 
Code Processor Messages 

Extended External Action 

External Action 

External Action Messages 

Interface 

JFCB Housekeeping Control 
and Allocate Processing 

JFCB Housekeeping Error 
Message Processing 

JFCB Housekeeping Error 
Messages 

JFCB Housekeeping Fetch DCB 
Processing 

JFCB Housekeeping GDG All 
Processing 

JFCB Housekeeping GDG 
Single Processing 

JFCB Housekeeping 
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Module Cross Reference 


This section contains an alphameric list of entry point and control section names, 
together with the name of the module that contains them. For further information on the 
modules, refer to the module descriptions. 
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| Entry Point or | | | Entry Point or | | 
| Control Section | Module Name | | Control Section | Module Name | 
| Name | | | Name | | | 

: | ------------------~-- }----~-------------- { | }---------—-—------ }------------—----- ! 
| GO | IEFSD515 | | IEESMFI3 | ITEESMFI13 | 
| LEAQOTOO | LEE0903D | | IEESMFI4 | LEESMFIT | 
| | | {| LEESMFMS | LEESMFI3 | 
| LTEECIR50 | THECIR50 | | TEESMFOIL | IEESMFOI | 
| | | | IEESMFOP | TEESMFOP | 
| LEEDFINA | {LEEDFINA ; §4 ILEESMFWT | LEESMFWT | 
| LTEEDFINB | LEEDFINB | | | | 
| TEEDFINC | ITEEDFINC | | TEEVACTL | TEEVACTL | 
| ITEEDFIN1 | IEEDFINI | | IEEVICLR | ITEEVICLR | 
| TEEDFIN2 | LEEDFIN2 | | IEEVJCL l TEEVIJCL | 
| | | | ITEEVLDSP | ITEEVLDSP | 
| LEEDFIN3 | LEEDFIN3 | | TEEVLIN l ITEEVLIN | 
| LEEDFIN4 | TEEDFING | | IEEVLNET | LEEVLNKT | 
| ITEEDFINS | ITEEDFINS | | | | 
| LEEDFIN6 | LEEDFIN6 | | IBEVACTL | IEEVACTL | 
| IEEDFIN7 | LEEDFIN7 | | IEEVRCTL | IEEVRCTL | 
| | | | IEEVLOUT | IEEVLOUT | 
| TEEDFIN8 | ITEEDFINS8 | | ILEEVOMSG | ITEEVOMSG l 
| IEBEDFINY | ITEEDFIN9 | | ITEEVPRES | LEEVPRES | 
| IEEDPART | TEEDFIN2 | | IEEVRC l ITEEVRC | 
| TEELOGO 2 | IEELOG02 | | | | 
| LEELWALT | LEELWAIT | {|  ITEEVRFRX | LEEVRFRX | 
| | | | LEEVRJCL | TEEVRICL | 
| IEEMSER | ILEESD568 | | | IEEVSMBA | ITEEVSMBA | 
| ITEEMSTWO | TEESD579 | | LEEVSMSG | TEEVSMSG | 
| IEEPSN | LEEPSN | | LEEVSTAR | LEEVSTAR | 
| ITEEREXIT | LEEDFIN9 l l LEEVTCTL l IEEVTCTL | 
{ ITEESD56 2 | IEESD562 | | { | 
| | | l TEX EDNA | ITEEXEDNA l 
| ITEESD563 { ITEESD563 | | ITEE0303D | IEEO 30 3D | 
| IEESD564 | LEESD564 | | IEEO303F | LEE0 30 3F | 
| ITEESD565 | IEESD565 | | IEEO403D | ITEEO 40 3D | 
| IEESD566 | ITEESD566 | | ITEEO4O3F | ITEEO 40 3F | 
| ITEESD575 | IEESD575 | | ITEE0503D | ITEEO 50 3D | 
| ( | | | | 
|  TEESD576 ; ITEESD576 | | ITEE0603D | IEE060 3D [ 
| IEESD577 | ITEESD577 | | IEEO703D | IEE070 3D | 
| IEESD578 | ITEESD578 | | ITEE0803D | IEE080 3D | 
| ITEESD579 i IEESD579 | | IEE10030 | IEE100 30 { 
| IEESD580 | IEESD580 | | IEE10110 | IEE10110 | 
i | | | IEE11110 | IEE11110 | 
| IEESD581 | ITEESD581 | | | | 
| TEESD58 2 | ITEESD582 | | ITEE1103D | ITEE110 3D | 
| ITEESD583 | LTEESD583 | | | IEE1203D | LTEE120 3D [ 
| ITEESD584 © | ITEESD584 | | ITEE12110 | ITEE12110 | 
| ITEESD590 | ITEESD590 | | ITEE1403D | ITEE140 3D | 
| | | | IEE1603D | IEE160 3D | 
i ITEESD591 | ITEESD591 | | IEE1703D | LEE1703D | 
| TEESD592 | ITEESD592 | | | | 

| TEESD8 2A TEESD582 | | IEELA03D | IEE1A0 3D | 
{| | TEESMFAL | LTEESMFAL | | LTEE1B03D { IEE1B0 3D | 

| ITEESMFIO | ITEESMFI3 | | LEE20110 | IEE20110 | 

| LEESMFIT | LEESMFIT | | IEE2103D | TEE210 3D | 

i | IEESMFI2 | ITEESMFI2 | | IEE21110 | IEE21110 | 
Oa Pe ES re Rene Rm ayy erry Re eee ere ese eee eer en ere | 
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au te Sia er eee rea 1 eer ay ae rr rae ep ee 1 
| Entry Point or | | | Entry Point or i 
| Control Section { Module Name | | Control Section | Module Name | 
| Name | | | Name | | 
Pr ee ee Pose 1 (eases 2 abs SGD Same { 
| ITEE22110 i ITEE22110 | | ITEFCVOL1 | IEFMCVOL | 
| ITEE2303D | ITEE2303D | | ITEFCVOL2 | ITEFCVFAK | 
| IEE23110 | TEE23110 | | LEFCVOL2 | ITEFMCVOL | 
| IEE2803D | ITEE2803D | | ITEFCVOL3 | LEFCVFAK | 
{ IEE2903D | ITEE2903D | | ILEFCVOL3 | ITEFMCVOL | 
| ITEE3103D | ITEE3103D | | TEFDPOST | ITEFSD567 | 
| | | | | | 
| TEE3203D | LEE3203D | | IEFDSDRP | IEFDSDRP l 
| TEE3303D | IEE3303D | | LEFDSOAL | IEFDSOAL | 
| ITEE3503D | IEE3503D | | | IEFDSOCP | IEFDSOCP | 
| IEE3603D l IEE3603D | | LEFDSOFB | IEFDSOFB | 
| ITEE3903D l LEE3903D | | LEFDSOSL | IEFSD511 | 
i ITEE40110 | TEE40110 | | | | 
| | | | ITEFDSOSM | LEFDSOSM | 
| TEE4103D | ITEE4103D | | IEFDSOWR | IEFDSOWR | 
| ITEE4203D | ITEE4203D | | LTEFIDMPM | LEFIDMPM | 
| ITEE4303D | IEE4303D | | IEFIRC | IEFSD533 | 
i ITEE4403D | IEE4403D | | IEFJOB | TEFQRESD | 
{ ITEE4503D | TEE4503D | | IEFKG | IEFSD532 | 
| ITEE4603D | ITEE4603D | | ITEFK1IMSG | ITEFK1MSG | 
| | { | | | 
| ITEE4703D | IE£4703D | | ILEFORMAT | ITEFORMAT | 
| TEE4803D | IEE4803D | | IEFPH2 | IEFSD531 l 
| IEE4903D | ITEE4903D | | IEFPPGM l IEFPPGM | 
| TEE5403D | TEE5403D | | IEFPRES | IEFPRES | 
| ITEE5503D | ITEE5503D | | IEFQAGST | LEFQAGST | 
IEE5603D | TEE5603D | |  IEFQASNM l IEFQASGQ | 
| | {| =| | | 
| IEE5703D | IEE5703D | | IEFQDELE | IEFQDELQ | 
| TEE5903D | IEE5903D | | LEFQMDQ2 | LEFQMDQQ l 
| IEE591SD | IEESD591 | | | IEFQMDUM | ITEFQMDUM | 
| IEE60110 | IEE60110 | | IEFQMNQ2 | IEFOMNOQQ | 
| ITEE6303D | IEE6303D | | LEFQMRAW | IEFQMRAW l 
| ITEE6403D | ITEE6403D | | | | 
| | | | IEFQMSSS | IEFQBVMS | 
| ITEE6503D | IEE6503D | | IEFOQMSSS | IEFQGMDUM | 
| ITEE6603D | ITEE6603D | | ITEFQMSSS | IEFQMLK1 | 
| IEE6703D | IEE6700D | | IEFQMUNC | IEFQMUNQ l 
| IEE6803D | IEE6803D | | ITEFRCLN1 | IEFRCLN1 | 
| IEE6903D | IEE6903D | | | | | 
IEE7103D | TEE7103D | | ILEFRCLN2 | IEFRCLN2 | 
| | | IEFRPREP | IEFRPREP | 
| LEE7203D | LEE7203D. | | -LEFSDPPT | LEFSDPPT | 
| IEE7303D | IEE7303D | | IEFRSTRT | IEFRSTRT | 
| IEE7503D | ITEEM503D | | LEFS DXxX | IEFSDXXX | 
i IEE7603D | IEE7603D | | | | 
| LEE7703D | IEE7703D | | LIEFSDXYZ | LEFSDXYZ | 
| LEE7803D | LEE7803D | | LEFSD012 | IEFVSD12 | 
| IEE7903D | IEE7903D | | ITEFSD017 | IEFSD017 | 
{ { | | IEFSD055 | IEFSD055 | 
| LEE8503D | IEE8503D | | IEFSD068 | IEFSD167 | 
| IEE8603D | IEE8603D | | | | 
| IEFACTLK | ITEFACTFK | | IEFSD068 | IEFSD168 | 
| IEFACTLK | ITEFACTLK | | IEFS D070 | IEFSD070 | 
| IEFACTLK | LEFSMF LK | | IEFSDO071 | IEFSD171 | 
| | | | | | - IEFSDO78 | LEFSD078 | 
| LEFACTRT | IEFACTRT | | IEFSDO78 | IEF078SD | 
| IEFALRET | IEFSD512 | | | IEFSDO79 | LEFSD079 
| IEFCVOL1 | LEFCVFAK | | | IFDSD079 | IEFO79SD | 
b—--__—__-__-_-_-----~~ se J |  LIEFSD080 | LEFSD0 80 l 
(continued) | . IEFSDO081 | IEFSD0 81 | 
| Cee ee ee Be See eee J 
(continued) 





Deeg pie ee a ere een Tg ee ee 1 9S Re a res ee eee Ree ee ee 1 
ge: | Entry Point or | | | Entry Point or | | 
{ | Control Section | Module Name | | Control Section | Module Name | 
4 | Name | | | Name | | 
pane manana nea faassen {9 ----~---------------- fanaa an anna f 

l IEFSD08 2 l LEFO82SD | | IEFS D569 | TEFSD569 | 

| IEFSD082 | ITEFSD082 | | ITEFSD572 | ITEFSD572 | 

| IEFSD083 | ITEFSD083 | | IEFS D573 | LEFSD572 | 

| IEFSD083 | LEFO83SD | | LEFS D584 | IEFSD584 | 

| ITEFSD084 | LEFSD084 | | TEFS D585 | TEFSD585 | 

| IEFSD085 | IEFSD085 | | LEFS D5 86 | LEFSD586 | 

| LIEFSD086 | ITEFSD086 | | | | 

| | | | ITEFSD5 87 | ITEFSD587 | 

| IEFSD087 | LEFSD087 | | IEFSD588 | IEFSD588 | 

| IEFSD088 | IEFSD088 | | ITEFSD589 | ITEFSD589 | 

| IFFSD089 | LTEFSD089 | | LEFSD598 | ITEFSD597 | 

| IEFSD090 | ITEFVSD13 | | LEFSD598 | LEFSD598 | 

| IEFSDO94 | ITEFSDO94 | | TEFS D599 | ITEFSD599 | 

| IEFSD095 | IEFSD095 | | | | 

| | | | LEFSD71M | LEFSD171 | 

| LEFSD095 | IKFSD195 | | LEFSD83M | LEFSD083 | 

| IEFSD096 | IEFSD096 | | ITEFSD85M | TEFSDO 85 | 
IEFSD097 | LEFSD097 | | IEFSD86M | ILEFSDO 86 | 

| IEFSD300 | LiLFSD300 | | IEFSD87M | IEFSD087 | 

| IEFSD300 | IEF 300SD | | IEFSD89M | IEFSDO 89 | 

| IEFSD301 | IEFSD301 | { | | 

| | | | IEFSMPAT | LTEFSMFAT | 

| LEFSD302 | IEFSD302 | | LEFSMFIE | IEFSMFIE | 

| LEFSD303 | LEFSD303 | | IEFSMFWI | ITEFSMFWI | 

| IEFSD304 | LEFSD304 | | LEFSMR | LEFRSTRT | 

| IEFSD304 | TEF304SD | | ITEFUCBL | ITEFWA000 | 

i TEFSD305 | LEFSD305 | | | | 

| | | l LEFUJI | IEFUJI | 

: | IEFSD308 | IEFSD308 | | LEFUJV | LEFUJV | 
i | IEFSD310 | LiFSD310 | | IEFUSI | LEFUSI | 
NS | LTEFSD311 | IEFSD311 | | LEFVAWAT | ITEFSD195 | 
| IEFSD312 | IEFSD312 | | LEFVDA | ITEFVDA | 

| ITEFSD41R | TEF41DUM | | | | 

| l | | LEFVDBSD | IEFVDBSD | 

| IEFSD51i0 | IEFSD510 | | TEFVEA | IEFVEA l 

| TEFSD51i1 | LEFSD511 | | IEFVFA | LEFVFA | 

| IEFSD5i2 | IEFSD512 | | LEFVFB | LTEFVFB | 

| IEFSD512 | LEFSD553 | | ITEFVGI | IEFVGI | 

| IEFSD513 | LEFSD513 | | LTEFVGK | ITEFVGK | 

| | | LEFVGM | LTEFVGM l 

| IEFSD514 | ITEFSD514 | | l | 

| © ITEFSD515 | IEFSD515 | | LTEFVGM1 | ITEFVGM1 | 

l IEFSD516 | IEFSD516 | | LEFVGM2 | LEFVGM2 | 

| IEFSD51i7 | LEFSD517 | | ILEFVGM3 | LEFVGM3 | 

| IEFSD518 | LEFSD518 | | LEFVGM4 | ITEFVGM4 l 

| | | | LEFVGM5 | LEFVGM5 | 

| IEFSD519 | IBFSD519 | | ILEFVGM6 | IEFVGM6 | 

| IEFSD530 | LEFSD530 | | LEFVGM7 | LEFVGM7 | 

. | IEFSD531 | ITEFSD531 { =| LEFVGM8 | ILEFVGM8 | 
| IEFSD534 | TEFSD534 | | | | 

| ITEFSD535 | ITEFSD535 | | ILEFVGM9 | ITEFVGM9 | 

| | | | IEFVGM10 | LEFVGM10 | 

. | IEFSD537 | IEFSD537 | | IEFVGM11 | ITEFVGM11 | 
IEFSD540 { TEFSD540 | | LEFVGM12 | IEFVGM12 | 

| TEFSD541 IEFSD541 | | LEFVGM13 | IEFVGM13 | 

| IEFSD554 | IEFSD554 | IEFVGM14 | ITEFVGM14 | 

i LEFSD555 | IEFSD555 | | ITEFVGM15 l LEFVGM15 | 

| IEFSD556 | IEFSD556 | | TEFVGM16 | LEFVGM16 | 

| IEFSD557 { ITEFSD557 | | ITEFVGMi7 | ITEFVGM17 | 

| IEFSD558 | IEFSD558 | | IEFVGM18 | ITEFVGM18 | 

| TEFSD559 | IEFSD559 | | LEFVGM19 l LEFVGM19 | 

EE nye epee tel eee eeeN eee mene ope Pena re cae ed oe eee J aerial eee eee a pel ee ae Ss at a tS J 
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ee a ag a a 1 
Entry Point or | | 
Control Section | Module Name | 

Name | | 
~~-------~----------- }-------------------| 
LEFVGM70 | LEFVGM70 | 
IEFVGM71 | LEFVGM71 | 
LEFVGM78 | LEFVGM78 | 
IEFVGS | LEFVGS | 
IEFVGT | LEFVGT | 
ITEFVHA | ITEFVHA | 
| | 

IEFVHAA | IEFVHAA | 
ILEFVHB | LEFVHB | 
IEFVHC | LEFVHC | 
ITEFVHCB | IEFVHCB | 
TEFVHE | TEFVHE | 
| | 

IEFVHEB | IEFVHEB | 
TEFVHEC | TEFVHEC. | 
LEFVHF | LEFVHF | 
IEFVHG | LEFVHG | 
ITEFVHH | TEFVHH | 
ITEFVHHB | LEFVHHB | 
| | 

LEFVHL | LEFVHL | 
LEFVHM l TEFVHM l 
LEFVHN | ITEFVHN | 
LEFVHO | LEFVHQ | 
IEFVHR | LEFSD536 | 
, | | 
ITEFVH1 | LEFVH1 | 
ITEFVH2 | LEFVH2 | 
LEFVINA | ITEFVINA | 
LEFVINB | LEFVINB | 
LTEFVINC | LEFVINC | 
| | 

IEFVIND | ITEFVIND | 
LTEFVINE | ITEFVINE | 
LEFVJ | LEFVJIMP | 
ITEFVJA | IEFVJA | 
ITEFVJIMSG | LEFVJMSS | 
| | 

IEFVK | LEFVKIMP | 
IEFVKMJ1 l IEFVKMSG | 
LEF'VKMSG | TEFVKMSG | 
ITEFVM | LEFVMLS1 | 
TEFVMCVL | LEFVMFAK | 
| | 

TEFVMCVL | LEFVMLS1 | 
LTEFVMOMI | LEFVMLS1 i 
ITEFVMSGR | LEFVMLS 6 | 
TEFVM1 | TEFVMLS1 | 
ITEFVM1 | LEFVMMS1 | 
: | | 
ITEFVMz | LEFVM2LS | 
ITEFVM3 | LEFVM3LS | 
ITEFVM4 | ITEFVM4LS | 
IEFVM5S | LEFVM5LS | 
ITEFVM6 | LTEFVMLS6 | 
| | 

ITEFVM7 { LEFVMLS7 { 
IEFVM76 | IEFVM76 | 
LEFVRRC | LEFVRRC | 
_IEFVRRCA | LTEFVRRC | 
la een are ia ee ata a 
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Entry Point or 
Control Section 
Name 


+ I a Sk i aa a le ea ag aa a a cae eee 


IEFVRRCB 
TEFVRR1 

LTEFVRR2 

ITEFVRR3 

ILFVSDRA 
IEFVSDRD 
ITEFVSMBR 
IEFV15XL 
TEFV1i5xXL 
ITEFVRZAE 
ITEFVR3AE 
ITEFWAO0O0O 


IEFWA002 
LEFWA7 

LEFWCOO0O0 
LTEFWCO00 
ITEFWCO02 
ITEFWDO0O 


ITEFWDOO0O 
ITEFWDOO1 
IEFWDO02 
ITEFWDMSG 
ITEFWEXTA 


IEFWLISD 
TEFWSMSG 
IBFWSTRT 
IEFWSWIT 
ITEFWSYP3 
IEFWT ERM 
ITEFW1 FAK 


ITEFW1FAK 
TEFW2 FAK 
ITEFW2 FAK 
IEFW21SD 
ITEFW21SD 


ITEFW22SD 
ITEFW31SD 
IEFW32SD 
LEFW32SD 
ITEFW41SD 
IEFW41SD 


ITEFW42SD 
ITEFKA 

ITEFXAMSG 
ITEFXHOO0O 
LEFXJMSG 
ITEFXJX5A 


IEFXJX5A 
ITEFXJ000 
ITEFXJ000 
LEFXKMSG 
ITEFXKO000 
LEFXTOO0O0 
IEFXTO02 


Module Name 


—---—----—-~—-—--—~-—~—-~+-| 


ITEFVRRC 
ITEFVRR1 
IEFVRR 2 
IEFVRR3 
LEFVSDRA 
IEFVSDRD 
LTEFVSMBR 
LTEFXJ IMP 
ITEFSD551 
IEFVRR2 
IEFVRR 3 
IEFWA000 


ITEFWAO 00 
IEFWA000 
ITEFWCFAK 
LEFWCIMP 
ILFWCFAK 
LTEFWDFAK 


ITEFWDO000 
IEFWD001 
ITEFWDO00 
IEFWDO00 
ITEFWEXTA 


ITEFSD210 
ITEFWSMSG 
IEFWSTRT 
LTEFWSW IN 
LEFWMSG 

ITEFWTERM 
ITEFSD410 


ITEF41FAK 
IEFSD410 
IEF 41 FAK 
IEFSD210 
IEFSD557 


IEFSD220 
ITEFSD310 
LTEFSD320 
IEFSD330 
IEFSD410 
IEF 41 FAK 


IEFSD420 
IEFXCSSS 
IEFXAMSG 
IEFXH000 
IEFXJMSG 
IEFSD552 


LEFXJ IMP 
ITEFXJ FAK 
IEFXJ IMP 
LTEFXKMSG 
LEFXK IMP 
IEFXATOOD 
IEFXTO02 


Sa a a iy a a ea ar en 4 
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Appendix B: 


Pra en re Mi er en er ee 1 Gree eae Ei Wee eg pe 7 
| Entry Point or | | | Entry Point | Module Name | 
A | Control Section | Module Name | | Name | | 
‘ | Name | | }---------—-—--—-—-------- 4+------—-—-----—-—------ | 
ee ee ae eee eee foe eee ee | | MSSYS | LEFXJMSG | 
| LEFXtT003 | LEFXT003 | | SD304MG1 | LEFSD312 | 
| LEFXVMSG | LEFXVMSG | | SD304MG2 | LEFSD312 
| LEFXVNSL | LEFXVNSL | |  SD305MG1 | LEFSD312 | 
| ITEFXVOO1 | ITEFAVFAK | | SD55MSG1 | IEFSD311 | 
| IEFXV001 | TEFXV0O01 | | SD55MSG2 | IEFSD311 | 
| LTEFXV002 | ThFXV002 | | SD55MSG3 | LTEFSD311 | 
| ITEFXV003 | TF XV003 | | SMALLGO | LEFSD599 | 
| IEFX3000 | IKFX300A | | SMALTERM l IEFSD515 | 
| TEFX5000 | TEFX5000 | | SMALT ERM | TEFSD559 | | 
| ITEFYN : TEFYNIMP | | SPRINTER | IEFPRINT | 
| LEFYNMSG | LEFYNMSS | | STRMSGO1 | LEFYNMSG | 
| LEFYP | IKFYPJB3 | | VM7000 | LBFVMLS1 | 
| LEFYPMSG l IEF YPMSG | | VM7055 | L#FVMLS1 | 
l IEFYS | LEFYSVMS | | VM7055AA | TH FVMLS1 l 
| | | { | VM7060 | TEFVMLS1 | 
| LEFYT | LEF YTVMS | | | | 
| IEFZA | IEF ZAJ33 | | | VM7070 | IEFVMLS1 | 
| LEFZG | IEFZGST1 | | | VM7090 | IEFVMLS1 | 
| LEFZGI | IEFZGJB1 | | | VM7100 | ITEFVM2LS | 
l LEFZGMSG | IEF ZGMSG- | | VM7130 | IEFVMLS1 
| LEFZG2 | LEFZGST2 l | VM7150 | LEFVM3LS | 
| IEFZH | IEF ZHMSG | | | 
{ ITEFO85SD | ITEFSDO085 | | VM7200 | ITEFVM4LS | 
| ITEFO86SD | ITEFSD086 | | VM7300 | ITEFVM5SLS | 
| ITEF589SP | ITEF589SP | | VM7370 | LTEFVMLS1 | 
| IEF850SD | ITEFSDO085 | | VM7600 | ILEFVM76 
| | | | VM7700 | IEFVMLS1 | 
| ITEZDCODE | ITEZDCODE | | VM7742 | ITEFIMIS1 | 
| IEZNCODE | LEZNCODE | | VM7750 | ITEFVMLS1 | 
| IGCO0005B | ITEFVSMBR | | VM7850 | ITEFVMLS1 | 
| 1GC00083 | IGC0008C | | VM7900 | IEFVMLS1 
| IGC00090 | ITEP XQOMOO | | VM7950 | IEFVMLS1 | 
| | | | | | 
| IGC01i03D | IGC0103D | | XIIB32 | LTEFX5000 
| IGC01090 | IEFXQMO1 | | xPs631 | LEFZHMSG | 
| IGC0203E | LEFWTP0O | | XTTEAO LEFXTO02 | 
| IGC02090 | LEFXQM02 | | XTTEA1 | LEFXTO002 | 
| IGC0303E | LEFWTPO1 | | XTTEB3 | IEFXT002 | 
| | | | XTTPOO | LEFXTOOD | 
| IGCO403E | LEFWTPO2 | | xXTTRDI l IEFXT002 | 
{| IGCc1803D | LEESD571 | | | XUUBOO l IEFXT003 l 
| IGC1903D l IEESD561 | |  XUUHO6 | LEFXT003 | 
| IGC3903D | IGC3903D | | X33B42 | IEFX300A | 
| IGF08501 | IGF08501 | | | | 
| | | | | X55C86 | ITEFX5000 | 
| | IGF08502 | IGF08502 | | X55D3G | IEFX5000 | 
| IGF13501 | IGF13501 | |  YPPMSG1 | LEFYPMSG | 
| IGF2403D | IGF2403D | | YPPMSG2 | IEFYPMSG | 
| IGF2503D | IGF2503D | | ZGOE60 | TEFZHMSG | 
| IGF2603D | IGF2603D | | | | 
| | IGF29601 | IGF29601 | | | ZGOKO9 | IEFZGST2 | 
| IGF29701 | IGF29701 | |  ZKODL | LEFZHMSG | 
| | | |  ZKOEL | ILEFZHMSG | 
| IGF55301 | IGF55301 | | ZOOA1L | IEFZGST2 | 
| IKJNULL | IKJNULL | | ZOOE10 | ITEFZGST2 | 
| Loc | IEFLOCDQ | | ZPOCLO | LEFZGST2 l 
| LOCCAN | ITEFLOCDQ | | ZPOQM | IEFZGJB1 | 
| LOCDQ | IEFLOCDQ | | ZPOQMGR1 | IEFZGST1 | 
| MSOFF | LEFXJMSG | |  ZPOQMGR2 | LEFZGST2 | 
{| | MSRCV | LEFXJMSG | L___--.__ 4 - J 
Pe ES ae ey ONT An RTE a Eco gee aa evo ee J 
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Module Descriptions 


This section contains a brief description 
of each of the modules used by the MFT 
level of job management. Modules are 
listed alphamerically by module name; 
associated with each module is a 
descriptive name, which indicates the major 
component of the system to which the module 
belongs. Each description contains a brief 
Statement of the purpose of the module. 
Where applicable, the description for each 
module includes the names of the module's 
entry points, the names of the modules to 
which the module passes control, the major 
tables and work areas to which the module 
refers, the module's attributes, and the 
names of the control sections that the 
module contains. 


IEECIR50O;: Master Scheduler -- Resident 
WAIT Routine 


This routine waits until a CSCB is chained 
representing a command to be processed, 
then passes control to ITEECIR51 to process 
the command. 


e Entry: IJIEECIR50 
e Exits: IEECIR51, IEE0O0110. 


e Attributes: 
resident 


Read-only, reentrant, 


e Tables/Work Areas: 
data area 


CSCB, M/S resident 


e Control Section: IEECIR50 


TEECIR51: Master Scheduler -- Command 
Analyzer 





This routine analyzes a command and passes 
control to the appropriate command 
processor Or return control to IEECIRS5SO. 


e Entry: IEECIR51 from ITEECIR50 


e Exits: IEESD562, IEEDFIN1, or IEECIR50 


e Attributes: Reentrant 


e Tables/Work Areas: cCSCB, M/S resident 
data area, UCM 


A ti Aen ita eed ER AEE AEN AA ERI MEN ST A RR OEE SS RP RR I A PE EE 
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Routine 


This routine creates the SMF dynamic 
storage configuration record for MFT. It 
is entered during SMF initialization and 
whenever a DEFINE Command is issued. 


e Entry: IEEDFINA from ITEESMFI2 during 


SMF initialization. From IEEDFIN9 
whenever a DEFINE command is issued. 
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® Exit: Return to caller. 
e Tables/Work Area: CVT, M/S resident 
data area, PIB, TCB, SMCA 


e Attributes: Reentrant 


e Control Sections: IEEDFINA 


IEEDFINB: Master Scheduler -- System 
Reinitialization Routine 2 


This routine waits for partitions to 
quiesce and then issues an ENQUEUE macro 
instruction specifying the boundary boxes. 


e Entry: LTEEDFINB 
e Exits: IEEDFINS 


e Attributes: Read/only, reenterable 


e Control Sections: IEEDFINB 


IEEDFINC: Master Scheduler -- DEFINE 


Command Validity Check Routine (Core 
Storage) 


This routine determines whether all 
information for the partition redefinition 
of core storage iS correct. 


e Entry: ITEEDFINC 
® Exits: ITEEDFINB, ILEEREXIT 


e Tables/Work Areas: DFINDATA, CVT, M/S 


resident data area. 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFINC 
IEEDFINI1: Master Scheaquler -- DEFINE 
Command Initialization Routine 


This routine sets up data areas for 
partition definition, issues a DEFINE 
COMMAND BEING PROCESSED message to all 
active consoles, and passes control to the 
appropriate processing module. 


e Entry: IEEDFIN1 
e Exits: IEEDFIN3, IEEDFIN4, IEEDFINS 


e Attributes: Read-only, reenterable 


e Control Sections IEEDFIN1I 


IEEDFIN2: Master Scheduler -- DEFINE 
Command Syntax Check and Router Routine 


This routine checks the syntax of DEFINE 
command statements. If a syntax error is 
discovered, the statement is ignored and an 
error message is issued. If the syntax is 
correct, the information is stored and 








control is passed to the appropriate 
routine. 


e Entry: IEEDFIN2, IKEDPART 


e Exits: ILEEDFINS5, ITEEDFIN6, LEEDFIN7 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN2 


LEEDFIN3: Master Scheduler -~ DEFINE 
Command Validity Check Routine (Processor 


storage) 





this routine determines whether all 
information for the partition redefinition 
of processor storage iS correct. 


e Entry: LIEEDFIN3 


e Exits: JTEEDFINC, IEKEREXI1 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN3 


IEEDFIN4: Master Scheduler -- DEFINE 
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This routine lists partition definitions. 


e Entry: IEEDFIN4 

e Exits: JIEEDFIN3, IEEDFIN5S 

e Attributes: Read-only, reenterable 

e Control Section: IEEDFIN4 
IEEDFINS: Master Scheduler -- DEFINE 
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This routine contains texts for operator 
messages required for DEFINE command 
processing. The message is constructed 
according to a code passed by the calling 
routine. IEEDFIN5 issues the requested 
message and passes control to IEEDFIN2 or 
the dispatcher. 


e Entry: IEEDFINS 

e Exits: IEEDFIN1, IEEDFIN2 or return to 
calling program 

reenterable 


e Attributes: Read-only, 


e Control Section: IEEDFINS 
IEEDFIN6: Master Scheduler -~ Time-Slice 
Syntax Check Routine 

This routine checks the TMSL subparameters 
for proper syntax. 


e Entry: IEEDFIN6 


e® Exits: JEEDFIN2, IEEDFIN5, IBFEDPART 


© Attributes: read-only, reenterable 


e Control Section: TEEDFIN6 


TEEDFIN?7]: 
Routine 


Master Scheduler -- Keyword Scan 


This routine checks keyword parameters for 
Syntax errors. if a syntax error is 
discovered, the erroneous entry and all 
following entries are ignored, and an error 
message is generated. If the syntax is 
correct, the information is stored. 


® Entry: LEEDFIN7 
e Exits: LEEDFIN2, ILEEDFIN3, IEEDFING, 
ITEEDFIN5, IDEEDPART 
e® Attributes: Read-only, reenterable 
e Control Section: ILIEEDFIN7 
IEEDFIN8: Master Scheduler -- System 





Reinitialization Routine - Part 1 


This routine assigns protection keys, marks 
dispatchable partitions that are not of 
zero Size, and checks that the number of 
problem program partitions does not exceed 
15. If no error is found, IEEDFINS builds 
reguest blocks and boundary boxes and 
updates the PIB and the TCBPIB field for 
the defined partition. 


e Entry: IEEDFIN8 

e Exits: IEEDFINY, ITEEREXIT 

e Attributes: Read-only, reenterable 

e Control Section: IJI#EDFIN8 
IEEDFIN9: Master Scheduler -- Command 


Final Processor Routine 


This routine updates the time-slice control 
element, if time-slicing is specified, and 
issues a message to all active consoles 
that processing is complete. 


IEEDFINY, ITEEREXIT 


e Entry: 


e Exits: JIEEDFINS, IEEDFINA 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFINY 


TEELOGO2: Master Scheduler -- Log Open 


Initialization Module 


This routine opens the system log at IPL 
time. 


e Entry: TEELOGO2 
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e Exit: IEFSD569 


e Tables/Work Areas: CVT, UCB, UCM, 
TIOT, M/S resident data area, JFCB, 
IEELCA, DCB. 


e Attributes: Refreshable 


e Control Section: IEELOGO2 
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IEELWAIT: Master Scheduler -- Log Wait and 
Writer Module 





This module writes data from the log buffer 
to the system log. 


e Entry: IEELWAIT 


e Exit: To Dispatcher 


e Tables/Work Areas: 
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CVT, LCA, MRC 


e Attributes: Resident 


RE ener ene OY ENS 


e Control Section: IEELWAIT 

IEEPSN: System Task Control -- Interpreter 
Post Scan Exit Routine 

This routine verifies that the program name 
in the EXEC statement of a starting 
procedure is in the table of system tasks 
that qualify to be started. 


e Entry: IEEPSN 
e Exit: Return to caller 


e Attributes: Reenterable 


e Tables/Work Areas: 
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Linkage table 


e Control Section: IEEPSN 
IEESD561: SVC _ 34 -- STOP INIT and START 
Command Processor (Part 1) 


This routine initially processes the STOP 
INIT and START commands. 


e Entry: 1G6C1903D 

e Exit: IEE3903D, TEER 020 for error 
messages 

e Tables/Work Areas: CVT, XSA 

e Attributes: Read-only, transient 

e Control Section: I16C1903D 
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Routine 
This routine checks syntax of the command 


and sets internal codes for queue search, 
if required. 
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e Entry: IEESD562 
e Exits: XCTIL to IEFSD563 for queue ( 


search, to IEESD566 for DISPLAY or ne 
MONITOR active, to LEEXENDA for DISPLAY 
CONSOLES, to IEESD565 for syntax error 


as nF 


e Attributes: Read-only, reenterable 


e External References: None 


e Control Section: IEESD562 


IEESD563; Master Scheduler -- Queue Search 
Setup Routine 


This routine determines which queue is to 
be searched, reads and scans the queue 
control record, establishes parameters for 
the search, and transfers control to the 
queue search module. IEESD563 will write 
out updated queue control records. 


e Entry: LTEESD563 
e Exits: XCIPL to IEESD564 to search 


queue; XCTL to IEESD565 at completion, 
XCTL to IEESD575 for CANCEL; XCTL to 
IEESD583 or IEESD584 for D2 or DN 


e Tables/Work Areas: QCR, QMPA, CVT, 


CSCB 
e Attributes: Read-only, reenterable 
e Control Section: IEESD563 


IEESD564:; Master Scheduler -- Queue Search 
Module 


This routine searches the work queues for 
the execution of the queue manipulation 
commands. 


e Entry: LEESD564 
e Exit: xXCTL to IEESD563 


® Tables/Work Areas: 
OMPA, XSA 


QCR, CSCB, CVT, 


e Attributes: Read-only, reenterable 


e Control Section: IEESD564 
IEESD565;° Master Scheduler -- Service 


Routine 


This routine frees storage obtained by 
IEESD563, links to the queue manager to 
enqueue an entry or queue control record on 
SYS1 .SYSJOBQE, or links to write a message. 


e Entry: IEESD565 Z 
e Exit: Return to caller Seer 


e Tables/Work Areas: 
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QMPA, CSCB, QCR, 


ft 

3 : 

. e Attributes: Read-only, reenterable 
e External References: IEFQMNQ2, 

LEE0503D 

e Control Section: IEESD565 

. IEESD566: Master Scheduler -- DISPLAY A 

Routine 


This routine builds a table and constructs 
Operator messages according to the 
processing required by a DISPLAY A command. 


e Entry: IEESD566 
e Exit: Return to caller (IEECIR50) 


e Tables/Work Areas: QMPA, CSCB, XSA, 


OCR, CVT 
e Attributes: Read-only, reenterable 
e Control Section: IEESD566 
LEESD568: Nucleus -- Master Scheduler 


Se A AS A aI 


This routine contains the master scheduler 
resident data area. 


e Entry: IEEMSER 
e Exit: None 


e Attributes: Not reusable 


e Control Section: IEEMSER 


IEESD571: SVC 34 -- DEFINE, MOUNT Routine 


This routine schedules the execution of the 
DEFINE and MOUNT commands. 


e Entry: I1G6C1803D 
e Exits: 
MOUNT —- XCTL to IGC0103D 


DEFINE - Return to caller 
XCIL to IEEOQ503D and IEE2103D due to 
error. 


e Tables/Work Areas: 
data area, CVT 


PIB, M/S resident 


e Attributes: Reenterable 
e Control Section: IGC1803D 
IEESD5753; Master Scheduler -- Queue 


Scratch Setup Routine 





This routine sets up the scratch parameter 
list. 


® Entry: ITEESD575 from IEESD563 or from 
TEES D583 
e Exit: XCTL to IEESD581 to Scratch or 





to ITEESD576 to delete queue entries. 


e Tables/work Areas: CSCB, CVT, JCT, 
JFCB, QMPA, SCT, SIOT, TIOT, UCB, UCB 
LOok up Figure 


e Attributes: Read-only, reenterable 


e® Control Section: LTEESD575 


IEESD576; Master Scheduler -- Queue Alter 


Delete Routine 


This routine goes to the Queue Manager 
delete routine IEFQDELQ to delete queue 
entries. 


e Entry: IEESD576 from IEESD575 
e Fxit: XCTL to ITEESD578 for message 


class setup. 


® Taples/Work Areas: 
JCT, SCD, SMB 


CSCB, CVT, DSB, 


e Attributes: Read-only, reenterable 


e Control Section: IEESD576 


IEESD577:; Master Scheduler -- Queue 
Restart Enqueue Routine 


This routine links to the queue manager 
enqueue routine IEFQMNQQ to enqueue data 
sets for a canceled restarting job. 


e Entry: IEESD577 from IEESD578 
e Exit: XCTL to IEESD579 


® Tables/Work Areas: 
SMB 


CSCB, OMPA, SCD, 


e Attributes: Read-only, reenterable 


e Control Section: IEESD577 


ITEESD578:; Master Scheduler -- Queue 
Message Class Setup 


This routine zeroes out the DSB's in the 

message class and sets up the QMPA for 

engqueuing the message class. 
e Entry: IEESD578 from ITEESD576 

e Exit: XCTL to IEESD579 to enqueue the 
message class; XCTL to IEESD577 <o 
enqueue the sysout data sets for a 
restarting job; XCTL to IEESD580 for 
message, XCTL to IEESD563 for queue 
search. 
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e Tables/Work Areas: 
QMPA, SCD, SMB 


CSCB, CVT, JCT, 


e Attributes: Read-only, reenterable 


e Control Section: IEESD578 
TEESD579:_ Master Scheduler -~ Queue SMB 
Routine 


This routine places the appropriate CANCEL 
message in the SMB and goes to the queue 
manager enqueue routine to enqueue the 
message class. The operator message is 
also issued from this routine. 
e Entry: IEESD579 from IEESD577 or 
- TEESD578 
e Exit: Return to IEECIR50 
e Tables/Work Areas: 
SMB 


CSCB, CVT, QMPA, 


e Control Sections: IEESD579, IEEMSWTO 


TEESD580: Master Scheduler -- Message 
Routine 


This routine issues the CANCEL WTO for 
those jobs that do not have the message 
class. 

e Entry: IE&SD580 from IEESD578 
e Exit: Return to IEECIR50 
e Tables/Work Areas: CSCB, QMPA 
e Control Sections: IEESD580 


TEESD581: Master Scheduler -- Queue 
Scratch Routine 


This routine issues the SCRATCH macro (SVC 
29) or an error message. 


IEESD581 from ITEESD575 


e Entry: 
e Exit: XCTL to IEESD575 


e Attributes: Read-only, reenterable 


e Control Sections IEESD581 


IEESD582: Master Scheduler -- ECB/IOB 
Construction Routine 


This routine builds an event control block 
and an input/output block used in a queue 
search. 


e Entry: IEESD582 or IEESD82A from 
IEESD562 | 
e Exit: xXCTL to IEESD563 for a queue 


search or to IEESD565 for a message 
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® Tables/Work Areas: CSCB, XSA 


e® Attributes: Reentrant 


e Control Sections: IEESD582 


ITEESD583: Master Scheduler -- Queue Search 


Return Routine 


This routine analyzes the results of a 
queue search made by the queue search 
routine, IFESD564. 7 


® Entry: IEESD583 
e Exits: XCrL to ITEESD563 for a queue 


search; XCIrL to IEESD565 for a message; 
XCTL to IEESD575 to cancel processing. 


e Tables/Work Areas: CSCB, CVT, OCR, 


OMPA 
® Attributes: Reentrant 
® Control Section: IEFESD583 


TEESD584; 
Message Setup Routine 


This routine writes the control and lapel 
lines for the DISPLAY Queue and the DISPLAY 
jobname commands. 


e Entry: IEESD584 from IEESD563 


® Exit: xXCTL to IEESD564 or IEESD583 
e Tables/Work Areas: CSCB 


e Attributes: Reentrant 


® Control Section: IEESD584 


IEESD590: System Task Control -- Write 
TIOT on Disk 


This routine writes the TIOT which is used 
by Job Selection (IEESD510) and checks for 
a small partition writer. 


e Entry: IEE£SD590 

e Exits: Return to IEFSD589 or XCTL to 
ITE&SD591 

e Tables/Work Areas: TIOT, SPIL 

e Attributes: Reenterable 

e Control Section: LEESD590 


IEESD591: System Task Control -- Linker 


Routine | 
This routine transfers control between 
system task control and a system task or a 
transient reader. 


e Entry: IEESD591, IEE591SD 


(2 ® Exit: Return to ITEFSD589 or IELF589SP 


e Tables/Work Areas: 
IWA, OMPA 


CSCB, CVI, PIB, 


e Attributes: Reenterable 


e Control Section: IEESD591 


re ee A NY SE SR 


Routine 


This routine posts the “no work" ECB in the 
PIB and clears the partition for further 
processing. 


® Entry: IEESD592 


e Exit: Return to IEFSD587 or IEFSD589 
e fTables/Work Areas: None 
e Attributes: Reenterable 


e Control Section: IEESD592 


IEESMFAL: SVC_83 -- SMF Allocation Routine 


This routine allocates devices for the SMF 
data sets. 


e Entry: IESSMFAL 

e Exit: IEESMFOP 

e Attributes: Reentrant 

¢ Tables/Work Areas: SMCA, CVT 

e Control Sections: IEESMFAL 
IEESMFIT: Master Scheduler -- SMF 
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This routine ootains storage for and 
initializes the SMCA, and reads the 
SMFDEFLT parameters from SYS1.PARMLIB. 


e Entry: IEESMFIT, IEESMFI4 
‘the 
e Exit: IEFSD569, IEESMFOI, IEESMFI2, 
LEESMFI 3 


e Attributes: Non-reentrant 


® Tables/Work Areas: 
Resident Data Area, 


CVT, DCB, JFCB, M/S 
SMCA, TIOT, UCB 
e Control Sections: IEESMFIT 


ITEESMFI2: Master Scheduler -- SMF 
Initialization Routine (2) 





This routine constructs the SMF IPL and 
initial online I/O device records, and 


engqueues the 10-minute TQE on the timer 
queue. 


e Entry: ILEESMFI2 


® Exit: To ILEEDFINA, LEESMFIT 


e Attributes: Non-reentrant 


© Control Sections: IEESMFIz 


ITEESMFI3: Master Scheduler -- SMF 
Parameter Processing Routine 


This routine processes the SMFDEFLT 
parameters and/or the SMF parameters 
entered from the operator's console. 
© Entry: LEESMFI3, ITEESMFIO, ITEESMPMS 
®@ Exit: IEESMPIT 
TEESMFT4 ) 


(at entry point 





® Attributes: Serially Reusable 


e Tables/Work Areas: CVT, M/S Resident 


Data Area, SMCA, UCB 


® Control Section: TEESMFI3 
IEESMFOI: Master Scheduler -- SMF Open 
Initializer 


This routine stores the DCBs and J®CBs for 
the SMF data sets. 


e Entry: LTLEESMFOL 
e Fxit: TEESMFIT 


e Attributes: Serially reusable 


e Tables/Work Areas: DCB, JFCB, SMCA, 
TIOT 


e® Control Sections: IEESMFOI 


ITEESMFOP: SVC 83 -- Open Routine 


This routine opens the SMF data sets, and 
Switches between the primary and alternate 
data sets. | 


e Entry: LEESMFOP 


e Exit: IEESMFAL, return to caller 


® Tables/Work Areas: 
TIOT 


DCB, JFCB, SMCA, 


e Attributes: Reent rant 


e Control Sections: IEESMFOP 


IEESMFWT: SMF Writer Routine 


This routine writes the contents of the SMF 
buffer in the SMF data set. 
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e Entry: IEESMFWT 

¢ Exit: return to caller 

® Tables/Work _ Areas: CVT, DCB, SMCA 
® Attributes: Reentrant 


e Control Section: IEESMFWL 


LEEVACTL: System Task Control -- 


Allocation Interface Routine 
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This routine sets up the interface between 
system task control and the 1/0 device 
allocation routine. 

* Entry: IBEVACTL 


e Exits: To IEFSD210, IEEVSMSG, 


IEEVICTL, or IEEVSMBA 
e Attributes: Reenterable 


e Control Section: I#EVACTL 


TEEVICLR: Internal JCL Reader 
This routine reads the internal job control 
language used in starting a reader or 
writer. 

e Fntry: IEBVICLR 

e Exit: Return to caller 

e Tables/Work Areas: DCBD 


e Attributes: Read-only, reenterable 


® Control Section: IEEVICLR 


LEEVJCL: System Task Control -~- JCL Edit 
Routine 


This routine constructs the internal job 
control language used in the START reader 
and START writer command execution 
routines. 


e Entry: IEEVJCL, from IEEVSTAR 
e Exit: xXCTL to IEEVRCTL 


e Tables/Work Areas: SDT, CSCB, JSEL, 
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e Attributes: Reenterable 


e Control Section: IEEVJCL 
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ITEEVLDSP: Master _ Scheduler -~-_ Log 
Dispatcher Routine 


This routine puts the log data set on the 
system output queue. 
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e Entry: LEEVLDSP 
® Exit: Master Scheduler 


° Tables/work Areas: M/S Resident Data 
Area, CT, IEELCA, UCB, JFCB. 


® Attributes: Reentrant 


Control Section: IEEVLDSP 


IEEVLIN: Master Scheduler -- Log 
Initialization Routine 


This routine initializes the system log. 


e Entr ITEEVLIN 


e Exit: IEFSD569, ITEEVLIN2 


e Tables/Work Areas: UCM, CVT, UCB, 
TIOT, M/S resident data area, IEELCA. 


e Attributes: Refreshable 


e Control Section: IEEVLIN 


ITEEVLNKT: System Task Control -- 
Link-Figure Module 


This module consists of a table of the 
program names that are specified in the 
EXEC statement for a system task. 


e® Entry: ILEEVLNKT 


e Attributes: Non-executable 


e Control Section: ILEEVLNKT 


IEEVLOUT: Log Data Set Reinitialization 
Routine 


This routine opens and closes the log data 
set to reinitialize the DSILSTAR and 
DSITRBAL fields of the DSCB associated with 
the log data set. 


e Entry: IEEVLOUT, from IEFSD171 
® Exit: IEFSD171 


e Tables/Work Areas: CVT, DSCB, LCA, M/S 
Resident Data Area 


e Attributes: Reenterable 


e Control Section: IEEVLOUT 


IEEVOMSG: System Task Control -- Message 
Writing Routine 


This routine assembles and writes messages 
to the operator. 


e Entry: JEEVOMSG 








® Exit: Return to caller 


e Control Section: IEEVOMSG 


IEEVPRES: Master Scheduler -- 


Public/Private Interface Routine 


this routine sets up the interface for 

volume attribute setting routine IEFPRES. 
e Entry: ITEEVPRES 

e Exit: To IEFPRES 


e® Tables/Work Areas: UCB 
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e Attributes: Reentrant 
e Control Section: IEEVPRES 
IEEVRC: System Task Control -- Interpreter 
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This routine performs general cleanup 
functions following the processing of the 
reader/interpreter. 
e Entry: IEEVRC 
e Exit: XCTL to IEEVACTL, Return to 
IEFSD589 


e Tables/Work Areas: CSCB, CVT, IEEPSN 
work area, JSEL, JSXL, M/S Resident 
Data Area, NEL, OMPA, JSWA 


e Attributes: Reenterable 


e Control Section: IEEVRC 


IEEVRCIL: System Task Control -- 


e 
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Reader/Interpreter Control Routine 





This routine provides an interface between 
system task control and an interpreter. 

e Entry: IJEEVRCTL 
e Exits: xXCTL to IEFVH1 


° Tables/Work Areas: CVT, CSCB, JSEL, 
JSOL, JSXL, JSWA, TIOT, OPT 


e Control Section: IEEVRCTL 
IEEVRFRX: Master Scheduler -- Table Lookup 
Routine 


This routine can be used to obtain the 
following information; the CVT address, the 
contents of a CVT entry, or the contents at 
the CVT pointer address, a pointer to the 
TCB or the RB, the TIOT pointer, the TIOT 
entry, the TIOT TTR, or the TIOT UCB 
pointer. The routine can also be used to 
insert a TiOT pointer, a TIOT TTR, or a 
TIOT UCB pointer in the CVT. 





e Entry: TEEVRERX 

® Exit: Return to calling program 

* Tables/Work Areas: CVT, TCB, RB, TIOT, 
UCB 

e Attributes: Reenterable 

® Control Section: IEEVRFRX 


IEEVRJCL: System Task Control -- Internal 
JCL Reader 


This routine reads the internal job control 
language used in starting a reader or 
writer. 


e@ Entry: IEEVRJCL 

® Exit: Return to caller 

e Tables/Work Areas: DCBD 

e Attributes: Read-only, reenterable 
e Control Section: IEEVRJCL 


IEEVSMBA: System Task Control -- QMPA 
Builder 


This routine constructs a queue manager 
parameter area (QMPA) referring to the 
message class queue for the use of the I/0 
Device Allocation routine. 


e Entry: LEEVSMBA 

e Exit: To IEEVACTL 

e Tables/Work Areas: OQOMPA, LCT, SMB, IOB 
e Control Section: IEEVSMBA 


IEEVSMSG: System Task Control -- Message 
Writer Routine 


This routine writes messages to the 
operator as required by the master 
scheduling task and system task control. 


e Fntry: ITEEVSMSG 


e Fxit: Return to caller 


e Control Section: IEEVSMSG 


IEEVSTAR: System Task Control -- START 
Command Syntax Check Routine 


This routine checks the syntax of a START 
command, and builds a start descriptor 
table (SDT) containing the parameters of 
the command. 


e Entry: IEEVSTAR 
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e Exits: or LEEO503D 
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To IEEVJCL, 


e Tables/Work Areas: SDT, M/S Resident 
Data Area, CVT, UCB XSA, and CSCB. 


e Attributes: Reenterable 


e Control Section: IBEVSTAR 


ae coat ST ete se setetannaateshnamanataanmnens iam icone adensnanstbamaticenenetio manadiaamaetetenes anemeannertaunankommmea aanegunecnee = smeemeenammtame et 


Termination Interface Routine 


This routine initializes the necessary 
tables for terminating a task that was 
established via a START command, and 
releases storage obtained by IEEVSTAR for 
the task's JSCB and WTPCB. 





e Entry: IlEEVTCTL 

e Exit: IEFQMSS, IEEVSMSG, IEFW42SD, 
ITEFQDELE, IEEPRTN2, ITEEVOMSG 

e Tables/Work Areas: CB, JCT, SCT, LCT, 
and CSCB 

e Attributes: Reenterable. Character 
Dependence Type C 

e Control Section: IEEVTCTL 

TEEXEDNA: Master Scheduler -- DISPLAY 
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CONSOLES Processor 


This routine processes the DISPLAY command 
with the CONSOLES operand and displays the 
system console configuration on the 
requesting console. 


e Entry: IEEXEDNA from IEESD562 


e Exit: To IEECIR50 


e Attributes: Reentrant 


e Control Sections: l1EEXEDNA 
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IEEO0110: SVC _110 -- M/S Router 


This routine passes control to the display 
processors for DISPLAY, DUMP, and MONITOR 
commands that involve status displays. 


e Entry: IEEO0110 (this routine is the 
first load of SVC110; SVC 110 is issued 
by IEECIR50.) 

e Exits: IEE10110, IIE20110, IEE40110, 
IEE60110 

e Attributes: Reentrant, transient 

e Tables/Work Areas: 
Data Area, XSA 


CSCB, M/S Resident 


118 Job Management with MFT (Release 21) 


| TEEO303D: 


SVC 34 -- CSCB and CIB Chain 
Manipulator 


This routine manipulates the CSCB and CIB 
chain as requested by the caller of SVC 34. 


e Entry: IEEO303D 
¢ Exit: To ITEE5403D, or return to caller 


e Tables/Work Areas: 
data area, CSCB, XSA 


CVT, M/S resident 


e Control Section: ILEEO303D 


IEEOQ303F: SVC 36 -- WRITE-TO-LOG 
This module copies text records from an 
input area to the log buffer and posts the 


log ECB when the buffer is full. 





e Entry: ITEEOQ303F 
e Fxit: Returns to Master Scheduler, 
IEEO4UO3F. 
e Tables/Work Areas: IEEBASEA, IEELCA, 
CVT 
e® Control Section: IEEQ303F 
IEFEOQ403D: SVC 34 -- Router Routine 


This routine identifies the command verb, 
ensures that the console has authority to 
enter the command, and passes control to 
the appropriate routine. 


® Entry: IEEO403D 
® Exit: Depending on command verb, via 





XCTL to another SVC 34 module 


® Tables/work Areas: M/S resident data 


area, XSA, CSCB 


e Control Section: IEEO4O3D 


IEEO4O3F: SVC 36 
Management Module 


(Load 2) -- Log Buffer 


This module opens, closes, and switches | 
system log buffers. 


e Entry: TEEO403F 
e Exit: IEEO303F 


e Tables/Work Areas: IEEBASEA, 
UCB, JFCB, DCB, CVT, TIOT. 


IEELCA, 


e Attributes: Reentrant 


e Control Section: IEEOQ403F 
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IEEQ503D: SVC _34 -- Message Assembly 


This routine assembles and edits messages 
for the command scheduling routine, and 
writes the messages to the operator. 


e Entry: IEEO503D 
°e Exit: Branch on register 14 


e Attributes: Reenterable, read-only 


e Control Section: IBEO503D 


LEEOQO603D: SVC 34 -- SET Command Routine, 
Part I 


This routine processes the SE&17 command 
Operands, CLOCK and DATE. 


e Entry: IEE0603D 


e Exits: ‘10 ITEEO503D or IEE8603)D 


@ Tables/Work Areas: XSA, CVT, M/S 


resident data area 


e Attributes: Reenterabie, 
self-relocating, read only transient 


e Control Section: I[EEO0603D 
TEEO703D: SVC _ 34 -- STOP and MODIFY 
Scheduling 


This routine schedules the execution of the 
STOP and MODIFY commands by finding and 
updating the appropriate CSC5 and by 
issuing a POST macro instruction to the 
master scheduling task. 


e Entry: IEEO703D 
e Exits: Branch on register 14, or XCTL 


to LERFO503D or IEE2103D. 


e Tables/Work Areas: M/S Resident Data 


a TE ee ee —— 


e Attributes: Reenterable, 
self-relocating, read-only, transient 


e Control Section: IEE0703D 


TEEOQ803D: SVC 34 -- CSCB Creation Routine 


This routine schedules the execution of 
commands that cannot be completely 
processed by the command scheduling 
routines. It performs this function by 
adding a CSCB to the CSCB chain and issuing 
a POST macro instruction to the master 
scheduling task. 


* Entry: IEE0803D 





e Fxit: ITEO5SO3D, ITEE2103D, or return to 


caller 


e Tables/Work Areas: XSA, M/S resident 
data area, CVT, CSCB, and UCM 


e Attributes: Reenterable, transient, 
partially disabled. 


e Control Section: 1EE0803D 
IEEO903D: SVC 34 -- Timer Maintenance 
Routine 


This routine processes the date and time 
operands of the StT command. 


e Fntry: TEAQOTOO 
* Exit: SVC 3 
* Tables/wWwork Areas: CVT 


e Attributes: Reenterable, supervisor 
State, disabled for system interrupts, 


transient 
e Control Section: IEAQOTOO 
ITEE10110: SVC 110 -- DISPLAY C,K Routine 
(Load 1) 


This routine begins processing of the 
DISPLAY C,K command by building the title 
and label lines of the display and writing 
them to the operator's console by means of 
the WTO macro instruction. 


e Entry: LTE#10110 from IEEO0O110 
® Exit: IEE11110 


e Attributes: Reentrant, privileged, 


transient 
e Tables/work Areas: CSCB, XSA 
IEE1103D: SVC 34 -- VARY and UNLOAD Scan 


Routine for Non-MCS Systems 


This routine examines the command and its 
operand. 


e Entry: I1EE1103D 
e Exit: IEE2203D for multiprocessing 


VARY commands, IEE2303D for VARY ONLINE 
and CONSOLES operands when SMF is 
present, to IEE3103D for all other VARY 
operands and UNLOAD, and to IEE0Q503D 
for errors. 


e Tables/Work Areas: XSA, CVT, M/S 
resident data area, and UCM. 


e Attributes: Reenterable, 
self-relocating, read-only, and 
transient. 
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IEE11110: SVC _110 -- DISPLAY C,K Routine 


(Load 2) 





This routine continues processing of the 
DISPLAY C,K command by building the middle 
portion of the display and writing the 
lines to the operator's console by means of 
the WTO macro instruction. 


e Entry: IE£11110 from IEE10110 
e Exits: IEE12110 


e Attributes: 
transient 


Reentrant, privileged, 


e Tables/Work Areas: CSCB, XSA 


e Control Sections: IEEi103D 


TEE1203D: SVC _ 34 -- REPLY Processor 

This routine checks the validity of the 
Operator's REPLY command, and moves the 
Operator's REPLY (if valid) to the buffer 
of the user that issued the respective 
WTOR. 


e Entry: IE£1203D 


e Exit: To IEE1B03D to issue error 


message 


e Tables/Work Areas: CVT, UCM, WOE, RQE, 
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CXSA 
IEE12110: SVC 110 -- DISPLAY C,K Routine 
(Load 3) 


This routine completes building of the 
DISPLAY C,K status display. 


e Entry: IEE12110 


e Exits: Return to caller (IEE00110) 


e Attributes: 
transient 


Reentrant, privileged, 


e Tables/Work Areas: CSCB, XSA 


e Control Section: IEE1203D 
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IEE1403D: SVC 34 -- HALT Routine 

This routine processes the HALT and SWITCH 
commands. The SWITCH command will result 
in special processing for SMF if it is in 
the system. The HALT command will cause an 
SVC 76 to be issued for a statistics 
update, the LOG data set to be closed, as 
well as any SMF processing that may be 
reguired. 


e Entry: IEE1403D from IEEO403D 


* e Exit: IEE1303D, TCAM on IEE0503D 
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e Tables/Work Areas: CVT, M/S Resident 
Data Area, SMCA, UCB 


e Attributes: Reentrant 


e Control Section: IEE1403D > 


ITEE1603D:3 SVC 34 -- LOG and WRITELOG 
Processor Routine 


This routine issues a WTL macro instruction 
when a LOG command is issued, and stores 
the WRITELOG command and posts the Log ECB, 
for WRITELOG processing. 


e Entry: IEE1603D, from ILEE0403D 
e Exit: IEEOQ503D for errors, and return 


to caller of SVC 34. 


e Tables/Work Areas: XSA, CVT, LCA, and 
M/S resident data area. 


e Attributes: Reentrant, 
self-relocating, read-only, and 
transient. 


e Control Sections: IEE1603D 


IEE1703D: SVC 34 -- VARY ONGFX/OFFGFX 


This routine processes the GVARY command. 
It checks the parameters for validity and 
if an error is found, it passes control to 
IEEOQ503D via an XCTL macro instruction. If 
the parameters are valid, the routine sets 
appropriate bits in the Overall Control 
Table (OCT) of the GFX reader task. It 
then issues a POST macro instruction on the 
ECB in the OCT for each graphics device 
(2250) placed in the online status. 


e Entry: IE#1703D 
e Exit: IEEO503D, return to issuer of 
SVC 34 


® Tables/Work Areas: CVT, OCT, XSA 


e Attributes: Reenterable, read-only, 
self-relocating 


e Control Section: IEE1703D 
ITEE1LA03D: SVC 34 -- MCS REPLY Processor 
Routine 


The purpose of this routine is to process 
valid operator replies to WIOR macro 
instructions in an MCS environment. 


e® Entry: ITEE1A0 3D 


e Exit: To IEE1BO3D 


e Tables/Work Areas: CVT, UCM, WQE, RQE, 
XSA 
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e Attributes: Reenterable, transient 


e Control Sections: LEE1IA03D 
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Routine 


This routine assembles, edits, and 
broadcasts the accepted reply to a WTOR 
Macro instruction for the MCS Reply 
Processor routine (module IEE1A03D) of the 
Command Scheduling routine, and to write 
error messages to the operator whose 
command is in error. 


e Entry: IEE1BO3D, from IEE1A03D 
e Exit: Return to the caller of svc 34 


® Tables/Work Areas: CVT, UCM, ROE, WOE, 
ASA 


e Attributes: Reenterable, transient 
e Control Sections: IEFE1B03D 


IEE20110: SVC 110 -- DISPLAY U_koutine 


(Load 1) 
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This routine begins processing of the 
DISPLAY U command by checking the command 
syntax and the UCB for the first device to 
be included in the status display. 


e Entry: IEB20110 from IEE00110 (Svc 110 
issued by IEECIR51 


e Exits: IEE21110, IEE22110, IEE23110 


e Attributes: Reentrant, privileged, 
transient 
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Routine 


This routine assembles and edits messages 
for the command scheduling routine, and 
writes the messages to the operator. 


e Entry: IEE2103D 
e Exit: Branch on register 14 


e Attributes: Reenterable, 
self-relocatory, read-only, transient 


e Control Section: IEE2103D 
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TEE21110: SVC 110 -- DISPLAY U Routine 


I eap-ansennieniimeninetadnemnioeneiean=iveniiemmmnsetimepiameaaar*enmiareenerneeemnmmennencantnisnnsanmmmimmmeetanimmmeaummenenmennmentemamtunmmnmtaeane deemmenaipemaendtemnsammmmaenmmennmaatineamseneme menmeemammenammiace ia acenal 


(Load 2) 


This routine continues processing of the 
DISPLAY U command by building display lines 
using information obtained from the UCB. 


@ Entry: IEE21110 
e Exit: IEBE23110, IEE22110 


e Attributes: Reentrant, privileged, 
transient 


e Tables/Work Areas: CSC3, Workarea 
obtained by GETMAIN, UCB, Device Name 
Table 


IEE221103 SVC 110 -- DISPLAY U Routine 
(Load 3) 


This routine issues information pertaining 
to the DISPLAY U commands. It also builds 
line entries for data cell entries in the 
display and performs final cleanup (freeing 
the workarea) before returning to IEEO0110. 


e Entry: 156822110 from IHE20110 or 
TEE23110 or LIEE2110 


® Exit: ITEE23110, I8F2110, or return to 
IEEOO0110 via XCTL 





e Attributes: Reentrant, privileged, 
type 4 SVC 


e Tables/Work Areas: CSCB, UCB Workarea 
from GETMAIN 


IEE2303D: SVC 34 -- SMF VARY Processor 


This routine initially processes the ONLINE 
and CONSOLES operand of the VARY command 
when the system has the SMF option. It 
builds and issues an SMF record for each 
device placed in online status. 


e Entry: IEE2303D from IEE1103D or 
TEE3303D 


© Exit: IEE3103D, IEE4203D, or IEFE4403D 
e Tables/Work Areas: CVT, SMCA, XSA 


e Attributes: Reentrant, read-only, 
self-relocating 


e Control Sections: IEE2303D 
This routine continues processing of the 


IEE23110: SVC 110 -- Display U Routine 
(Load 4) 


This routine continues processing of the 
DISPLAY U command by locating UCBs that 
Satisfy the command and by writing lines of 
the display (create by loads 2 and 3) to 
the operator's console. 


e Entry: I1EE23110 from IEE20110, 
IEE21110 and IEE22110 


e Exits: IEE21110 and IEE22110 
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¢ Attributes: 
transient 


Reentrant, privileged, 


e Tables/Work Areas: 
From GETMAIN 


UCB, CSCB, Workarea 


TEE2803D: SVC 34 -- CANCEL Command 
Processor 


This routine checks the syntax of and 
processes the CANCEL command. 


e Entry: IEFE2803D 


e Exit: BALR to ABTERM 
XCTL to IEE0803D 
XCIL to IEE0503D and IEE2103D for 
messages 


e Tables/Work Areas: 
Resident data area 


CSCB, TCB, M/S 


e Attributes: Read-only, reenterable 


e Control Section: IEE2803D 
IEE2903D: _SVC_34_-- Display Requests 
Routine 


This routine displays to the requesting 
Operator the ID of all outstanding WTORs, 
the unit name of each device for 
outstanding MOUNT messages, and an 
indication as to whether any AVR mount 
messages are pending. | 


e Entry: IEE2903D, from IEE0803D 


e Exit: Return to caller of SVC 34 
¢ Tables/Work Areas: Message work area 


e Attributes: Reentrant, Refreshable, 


transient 
e Control Sections: I1EE2903D 
IEE3103D: SVC 34 -- VARY and UNLOAD 





Processor Routine 
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This routine processes the UNLOAD command, 
all VARY command operands in a system 
without the MCS option, and VARY ONLINE and 
OFFLINE operands for non-console devices in 
a system with the MCS option. 


e Entry: IEE3103D, initially from 
IEE1103D or IEE2303D and returns from 
TEE4603D. 


e Exit: Return to Caller 


e Tables/Work Areas: 
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resident data area, 


XSA, UCM, CVT, M/S 
and UCB. 


e Attributes: Reentrant, 
self-relocating, read-only, transient. 
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e Control Sections: IEE3103D 


LEB3203D:; SVC 34 - VARY Keyword Router 
Routine 


This routine identifies the first keyword 
in a VARY command, checks its validity, and. 
passes control to the appropriate command 
keyword processing routine. 
e Entry: IEE3203D from IEEO403D 
¢ &xit: To IFE1103D, IEE3303D, 
IEE4703D, IEE2403D, IEEi703D 


IFE4303D, 





e Tables/Work Areas: XSA 


e Attributes: Reentrant, read-only, 
self-relocating 


e Control Sections: IEE3203D 
TEE3303D: SVC 34 ~~ MCS VARY Syntax Check 
Routine 


This routine scans the command syntax in an 
MCS environment. 





e Entry: ITE&£3303D from ITEE3203D 
e Exit: IEE2303D, IEE2203D, IEE4203D, or 
ITEEG&4O3D 


e Tables/Work Areas: XSA, UCB, UCM, CVT 


e Attributes: Reenterable, 
self-relocating, read only 


e Control Sections: IEE3303D 
ITEE3503D: SVC 34 -- DISPLAY Command Router 
Routine 


This routine examines the operand of 
DISPLAY commands and passes control to the 
routine that processes the command. it 
also processes all MONITOR commands. 





e Entry: TEE3503D from IEEO403D 
* Exits: ITEE7503D, IEE1303D, IEE5803D, 
IEE2903D, IEEO803D, IEEQ503D, IEE8503D, 


ITEE2103D or return to caller 


e Tables/Work Areas: M/S resident data 
area, XSA, CVT, and UCM 

e Attributes: Reenterable, transient 

e Control Section: IEE3503D 


TEE3903D: SVC 34 -- STOP INIT and START 
Command Processing Routine (Part 2) 


This routine completes the processing of 
the STOP INII and START commands. 








© Entry: I1G6C3903D 


@ Exit: Return to caller 


e Tables/Work Areas: CVT, XSA, CSCB, 
PIB, M/S resident data area 
transient 


e Attributes: Read-only, 


e Control Section: IkE3903D 


ITEE40110: 
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This routine builds a display of PFK 
definitions, requested py the DISPLAY PFK 
command, and writes the display to the 
operator's console. 


e Entry: IEE40110 


e Exit: IEEO0110, for return to 


Supervisor 
e Attributes: Reentrant, transient 


e Tabdles/Work Areas: DCM 


TEE4103D: SVC 34 -- Hardcopy Message 
Issuing Routine 


This routine issues messages concerning the 
Status of the hard copy log. 


e Entry: IEE4103D, from ITEE4703D 


e Exit: Return to caller 


°e Tables/Work Areas: XSA, 


UCB, CVT, XSA, and UCM 


message area, 


e Attributes: Reentrant, transient 


e Control Sections: IEE4103D 
IEE4203D: SVC 34 -- VARY Secondary Scanner 
Routine 


This module performs authority and operand 
validity checking, and passes control to 
the routine that will process the command. 


e Entry: IEE4203D, from IEE3303D or 
IEE2303D 

e Exit: To IEE3103D, IEE4603D, or 
IEE4¥903D 

e Tables/Work Areas: XSA, CVT, UCM, and 
UCB. 

e Attributes: Reenterable, 


self-relocating, read-only, transient 


e Control Sections: IEE4203D 


ITEE4303D: 


This routine processes the VARY MSTCONS 
command. 


e Entry: TEER4303D from ITBEE3203D VARY 
CONSOLE 
e Exit: fo LEEO503D or IEE2103D on 


errors, SVC 72 to Console Switch 
Routine (module IEECMCSW) and upon 
return to caller of SVC 34 
e Tables/Work Areas: and 
UCM 


UCB, CVT, XSA, 


e Attributes: 
self-relocating, 


Reentrant, 
read-only, transient 


e Control Sections: IEE4&303D 


IEE4403D: SVC 34 -- VARY Scan Routine 
This routine determines the validity of 
VARY CONSOLE and sets appropriate bits in 
the XSA. 


e Entry: 
LEE2303D 


IEE4403D, from ITEE3303D or 


e Exits: IEE4203D, IEEO503D, IEE2103D 


e Tables/Work Areas: XSA, UCM, CVT, and 


UCB 


e Attributes: Reentrant, transient 


e Control Sections: IEE4403D 
ITEE4503D: SVC 34 -- Periodic STOP/STOPMN 
Command Handler Routine 


This routine syntax scans the STOP and 
MODIFY commands and processes the STOP 
JOBNAMES/STATUS/SPACE/DSNAME commands in a 
non-MCS environment. — 


e Entry: IEE4503D, from ITEEO403D 

e Exits: IEEOQ703D, IEEQO503D, IEE2103D, 
TEE5503D, LEE7503D, return to caller 

® Tables/Work Areas: XSA, M/S resident 
data area, CVT, and UCM 

e Attributes: Reentrant, 


self-relocating, read-only, transient 


® Control Section: IEE4503D 


TEE4603D: SVC 34 -- VARY ONLINE/OFFLINE 
Routing Routine for Console Devices 


This routine processes VARY ONLINE/OFFLINE 
for all MCS consoles. 


e Entry: IEE4603D, from ITEE4¥203D to 
process VARY ONLINE-OFFLINE 
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e Exit: IEE3103D or return to caller 


® Tables/Work Areas: XSA, CVT, UCB, UCM, 


and M/S resident data area 


e Attributes: Reentrant, 
self-relocating, read-only, transient 


e Control Sections: IEE4603D 
1EE4703D: SVC_34 -- VARY HARDCPY Processor 
Routine 


This routine processes VARY HARDCPY 
commands. 


e Entry: IEE4703D from IEE3203D 


e Exit: To IEE5703D or IEE7203D 


e Tables/Work Areas: 
resident data area, 


XSA, UCM, M/S 
CVT and UCB 


e Attributes: Reentrant, transient 


e Control Sections: IEE4703D 
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This routine constructs a message which 
shows the current status of the varied 
console. 


e Entry: IEFE4803D, from IEE4903D 


e Exit: IEE7303D, return to caller 


XSA, message area, 


UCB, CVT, and UCM 
e Attributes: Reentrant, transient 


e Control Sections: IEE4803D 


IEE4903D: SVC_34 -- VARY CONSOLE Processor 


Routine 


This module processes the VARY CONSOLE 
command. 


e Entry: IEE4903D, from LTE#4203D 


e Exit: To IEE4803D to construct console 


message 


e Tables/Work Areas: xXSA, CVT, UCB, and 
UCM 

e Attributes: 
self-relocating, 


Reentrant, 
read-only, transient 


e Control Sections: IEE4903D 
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ITEE5403D: SVC 34 -- Command Translator 


Routine 


This routine translates lower case letters 
(except those within apostrophes) into 
upper case letters. | 


e Entry: IEE5403D 
°e Exit: IEEO403D 


® Tables/Work Areas: CVT, Internal 
Translation Table, UCM, UCME, XSA 
® Control Section: IEE5403D 


ITEE5503D: SVC 34 -- STOPMN Command dandler 


Routine (Load 2) 


This routine terminates action initiated by 
the MONITOR command. 


e Entry: IEE5503D from IEE4503D 
e Exits: J[EH6703D, or return to caller 


e Tables/Work Areas: XSA, M/S resident 


data area, CVT, UCM 


e Attributes: Reentrant, 
self-relocating, read-only, transient 


@e Control Section: IEE5503D 


IEE5603D: SVC 34 -- MSGRT and CONTROL 
Message Module (Load 1) 


This routine issues error messages 
resulting from routing location (MSGRT or 
L = caa) errors and errors involving 
CONTROL command. 


e Entry: IEE5603D 
e Exit: IEE5903D, return to caller 


e Tables/Work Areas: DCM, UCM, XSA 


e Attributes; 
4 SVC 


Reentrant, transient, type 


ITEE5703D; SVC 34 -- VARY Hardcopy OFF and 
Message Routing Routine 


This routine removes the hardcopy log and 
routes any error messages to the > 
appropriate error message routine. 


e Entry: IEE5703D, from IEE4703D 
e Exit: IEEO503D or IEE2103D 


e Tables/Work Areas: 
MRC 


XSA, UCM, UCB, CVT, 


e Attributes: Reenterable, transient ; 


e Control Section: IEE5703D 
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Message Module (Load 2) 


This routine issues error messages | 
resulting from routing location (L = cca), 
message routing defaults (MSGRT command), 
Or CONTROL command errors. This module 
completes processing that was begun by 
IEE5603D. | 


e Entry: IEE5903D from IEE5603D 
e Exit: Return to caller 


e Attributes: Reentrant, transient, type 
4 SVC 


e Tables/Work Areas: DCM, UCM, XSA 


IEE60110: Master Scheduler -- DUMP Command 
Processor Routine 


This routine handles DUMP commands entered 
from the operator's console. The DUMP 
command provides a core image dump to the 
SYS1.DUMP data set. 


e Entry: IEE60110 
e Exit: IEE7903D 
e Attributes: Reentrant 


® Control Section: IEE60110 


IBE6303D: SVC 34 -- MSGRT Command Routine 
(Load 1) 


This routine processes default routing 
specifications entered by means of the 
MSGRT command (with the exception of MSGRT 
REF, which is handled by IEE6403D). 


e Entry: MIEE6303D 


e Exit: XCTL to IEE6403D or return to 
caller 


e Tables/Work Areas: UCM, XSA, MRCT 


e Attributes: Reentrant, transient, type 
4 Svc 


e CSECT: IEE6303D 


ITEE6403D: SVC 34 -- MSGRT Command Routine 
(Load 2) 


This routine processes the MSGRT REF 
command and constructs the required 
display. | 

e Entry: IEE6403D from IEE6303D 


® Exits: IEE5603D or return to caller 


e Attributes: Reeatrant, transient, type 
4 SVC 


e Tables/Work Areas: UCM, XSA, DCM, RCT 
Message Routing Routine 


IEE6503D: SVC 34 -- SET Time-Of-Day (TOD) 


Clock Routine, Part I 


This routine performs processing for the 
TOD clock for System/370 models. It 
calculates the discrepancy between the 
currently indicated time and the new time 
being set; it also calculates the time at 
midnight to maintain the correct date and 
then passes these values to IEE6603D. 


e Entry: IEE6503D 


e Exit: IEE6603D 


e Tables/Work Areas: CVT, M/S Resident 
Data Area, XSA 


e Attributes: Reentreable, transient, 
disabled for system interrupts 


® Control Section: IEE6503D 


ITEE6603D: SVC 34 -- SET Time-of Day (TOD) 


Clock Routine, Part II 


This routine sets the TOD clock, updates 
the CVT, and updates TSO and system TQOE's, 
uSing values passed from IEE6503D. It then 
issues a message indicating that the SET 
command has been processed. 


e Entry: IEE6603D 
e Exit: Return to issuer of SVC 34 


* Tables/Work Areas: CVT, XSA, M/S 
resident data area 


e Attributes: Reenterable, transient, 
disabled for system interrupts 


e Control Section: IEE6603D 


IEE6703D: SVC 34 -- CONTROL Command 
Handler (Load 1) 


This routine performs syntax check and 
processing for STOPMN; CONTROL E; CONTROL 
D; CONTROL S; CONTROL V; and CONTROL N. It 
passes control to other modules for CONTROL 
A; CONTROL M; CONTROL C. It also passes 
control to an error message module 
(IEE5603D) if an error is encountered. 


e Entry: IEE6/03D from IEE7503D 


e Exits: IEE7703D, IEE7803D, IEE5603D or 
return to caller. 





e Attributes: Refreshable, privileged, 
type 4 SVC 


e Tables/Work Areas: XSA, DCM 
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IEE6803D: SVC_34 -- CONTROL Command 


Handler (Load 2) 


this routine processes CONTROL A command 
(except CONTROL A, REF, which is processed 
by IEE6903D). 


e Entry: IEE6€¢803D from ITEE7803D 


e Exit: IEE5603D or return to caller 
® Attributes: Refreshable, privileced, 
type 4 SVC 3 


« Tables/Work Areas: XSA, CVT, UCM, 
UCME, DCM SACB ID list (this table is 


constructed by this module) -. 





ITEE6903D: SVC 34 -- CONTROL Command 
Handler (Load 5) 


This routine handles CONTROL A, REF 

commands. 
e Entry: IEE6903D from IEE7803D 

e Exits: IEE5603D or return to caller 


® Attributes: 


Refreshable, privileged, 
type 4 Svc | 
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ITEE7103D: SVC 34 -- MONITOR Command Router 


This routine identifies the MONITOR command 
and routes control to the appropriate 
routine for further processing. 
e Entry: IEE7103D from IEE3503D 
e Exit: IEEOQ503D, IEE2103D, IEE7503D, or 
return to caller 
e Attributes: Reentrant, transient 


e Tables/Work Areas: 
Resident Data Area 


XSA, CVT, UCM, M/S 





IEE7203D: SVC 34 -- VARY HARDCOPY UNIT 
Processor | 


This routine process HARDCOPY or UNIT 
Operands of the VARY command. 


e Entry: IEE/203D from ITEE4703D 
e Exit: IEE4103D, IEE5703D 


e Attributes: Reentrant, transient, 


privileged 


e Tables/Work Areas: CVT, UCM, XSA, UCB, 
M/S Resident Data Area . 
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IEE7303D: SVC 34 -- MCS Console 
Information (Load 2) 


This routine constructs messages displaying 
console configuration resulting from VARY 
commands. 


e Entry: LTEE7303D from IEE4803D 
e® Exits: IEE4803D or return to caller 


e Attributes: Reentrant, transient 

e Tables/Work Areas: XSA, UCB, UCM, 
UCME, Buffer Core, DCM (including the 
SACBs ) 


IEE7503D: SVC 34 -- Routing Location 
Routine (Load 1) 


This routine processes location operand (L 
=cca) and message routing defaults for 
CONTROL, STOPMN, DISPLAY and MONITOR 
commands: 


e Entry: IEE7503D from IEE3503D, 
ILEE7103D, IEE4503D, IEEO403D 

e Exits: IEE6703D, IEE7603D, IEE5603D 

e Tables/Work Areas: XSA, RCT, UCM, 


Resident DCM (including SACBs), M/S 
Resident Data Area 


e Attributes: Reentrant, refreshable, 
privileged, type 4 SVC 


e CSECT: IEE7503D 


IEE7603D: SVC 34 -- Routing Location 
Module (Load 2) 


This routine continues processing of the 
routing location operands (L = cca) of the 
DISPLAY, MONITOR or STOPMN commands. fThis 
processing starts with module IEE7503D. 


e Entry: IEE/7603D from IEE7503D 
e Exits: IEE0O803D, IEE5503D, or return 





to caller 


e Attributes: Reentrant, refreshable, 
privileged, type 4 SVC 

e Tables/Work Areas: XSA, UCM, Resident 
DCM (including the SACBs), M/S Resident 
Data Area 


IEE7703D: SVC 34 -- CONTROL Command 
Handler (Load 3) 


This routine processes CONTROL M commands. 


e Entry: IEE7703D from IEE6703D 
e Exit: IEE5603D or return to caller 


ae 4 





e Attributes: 


ee ec cS 


type 4 svc 


Refreshable, privileged, 


e Tables/Work Areas: UCM, WQE, XSA 


IEE7803D: SVC 34 -- CONTROL Command 
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This routine processes CONTROL C commands. 


e Entry: IEE/7803D from IEE6703D 
e Exit: ITEE5603D, IEE6803D, IBE6903D or 


return to caller 


° Attributes: 
4& SVC 


Reentrant, transient, type 


e Tables/Work Areas: 
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XSA, UCM, WOE 


ITEE7903D: SVC 34 -- Message Module 

This routine assembles and edits messages 
for the DUMP Command Processor, and writes 
the message to the operator. 


e Entry: IEE7903D 


* Exit: Return to caller 


e Attributes: 


Reentrant 


e Control Section: IEE7903D 


TEE8503D:_  SVC_-~- DISPLAY SQA Routine 
This routine displays the low and high 
boundaries of the SQA and the amount of 
free storage within the SQA. 


e Entry: IEE8503D from LTEE3503D 


e Exit: Return to caller 


M/S Resident Data 
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Area, XSA, CVT 


e Attributes: 


Reentrant 
e Control Section: IEE8503D 
ITEE8603D;3 SVC 34 -- SET Commcnd Routine, 
Part II 


This module processes the SET command 
parameters: QQ, PROC, and AUTO. 


e Entry: IEE8603D 
e Exit: To IEEQ903D, IEE6503D, IEE0503D, 


Or return to caller 


e Tables/Work Areas: CVT, Master 
Scheduler Resident Data Area, XSA 


e Attributes: Reentrant, 
self-relocating, read-only, transient 





e Control Section: JIEE8603D 


IEFACTFK: Termination -- User Dummy 
Accounting Routine 


This routine takes the place of the user's 
accounting routine when a user accounting 
routine was specified at system generation, 
but none was supplied. 


e Entry: IJIEFACTLK 
e Exit: Return to caller 
e Control Section: IEFACTLK 
LEFACTLK: Termination -- User Accounting 


Routine Linkage Routine 


This routine provides linkage between the 
termination routine and the user's 
accounting routine. It also sets up the 
required parameter list -- including the 
execution time of the job step -- and reads 
the first record of the account control 
table. 


e Entry: IEFACTLK 
e Exits: To user's accounting routine, 


return to caller. 


e Tables/wWwork Areas: LCT, JCT, SCT, 
JACT, SACT, OMPA 
e Control Section: ILEFACTLK 


IEFACTRT: Termination -- Dummy Accounting 
Routine 


This routine takes the place of the 
user-supplied accounting routine. 


* Entry: IEFACTRT 


e Exit: Return to caller 


@® Control Section: ILIEFACTRT 


IEFAVFAK: 
to ITEFXVOO0O1 


I/O Device Allocation -- Linkage 


This routine passes control to the AVR 
routine (IEFXV001) via and xCTL macro 
instruction. 


e Entry: LEFXV001 


e Exit: xXCTL to IEFXVOO01 


e Control Section: IEFXV001 


IEFCVFAK: I/O Device Allocation -- Linkage 
to ITEFMCVOL 


This routine passes control to Mount 
Control-Volume Routine IEFMCVOL via an XCTL 
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macro instruction to one of three entry 
points, IEFCVOL1, IEFCVOL2, or IEFCVOL3. 


e Entries: IEFCVOL1, IEFCVOL2, IEFCVOL3 


e Exits: XCTL to IEFCVOL1, IEFCVOL2, 
ITEFCVOL3 


e Control Section: IEFCVOL1 


IEFDSDRP: Data Set Descriptor Record 
Processing Routine 


This routine processes the job queue 
information in the DSDR record to make a 
restarting job's queue entry reflect the 
environment when the checkpoint was taken. 


e Entry Point: IEFDSDRP 


e Exit: Return to caller 

e Tables/Work Areas: JCT, SCT, SIOT, 
JFCB, TIOT, UCB, CVT, VOLT, TCB, QOMPA, 
CSCB, DCBD, DCB, JFCBX, SCTX, LCT 


e Attributes: Reenterable 


e Control Section: IEFDSDRP 


IEFDSOAL: Direct System Output -- SIOT and 
JFCB Modification 


This routine modifies the SYSOUT SIOTs and 
JFCBs of steps that will use DSO. 


e Entry: IEFDSOAL from IEFVMLS1 


e Exit: IEFVMLS1 or IEFQBVMS 
e Tables/Work Areas: CVT, LCT, QMPA, 
DSOCB, JCT, SCT, SIOT, JFCB, PIB, UCB 


e Attributes: Reenterable 


e Control Sections: IEFDSOAL 


IEFDSOCP: Direct System Output -- 


Initialization Routine 


This routine initializes DSO by 
constructing the DSOCB and performing DSO 
housekeeping. 


e Entry: LEFDSOCP 
e Exit: Return to caller 


e Tables/Work Areas: MTCB, DSOCB, TIOT, 
JFCB, UCB, CVT, ECB/IOB, QMPA, PIB 
e Attributes: Reenterable 


e Control Sections: IEFDSOCP 
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IEFDSOFB: Direct System Output -- Release 
DSOCB_ Routine | 


This routine frees DSOCBs allocated to a 
job. 


e Entry: 
IEFSD518 


IEFDSOFB from IEFSD168, or 


e Exit: Return to caller 


e Tables/Work Areas: LCT, DSOCB, CVT, 
PIB, M/S resident data area, JCT 
e Attributes: Reenterable 


e Control Sections: IEFDSOFB 


IEFDSOSM: Direct System Output -- Stop and 
Modify Command Processing Routine 


This routine processes Stop and Modify 
commands for DSO. 


e Entry: ITEFDSOSM 
e Exit: 


Svc 3 


e Tables/Work Areas: CVT, JCB, DSOCB, 
UCB, PIB, CSCB, JCT, ECB/IOB, QOMPA 


e Attributes: Reenterable 


e Control Sections: IEFDSOSM 


IEFDSOWR: Direct System Output -- System 
Messages and Job Separator Writer 


This routine writes job separators and 
system messages to the assigned DSO device. 


e Entry: 


IEFDSOWR from IEFSD512 or 
IEFSD310 | 


e Exit: IEFSD512, IEFSD31Q, IEFQMRAW, 
IEFSD094 or the user‘s separator 


program 


e Tables/Work Areas: MTCB, LCT, QMPA, 
DSOCB, JCT, SCT, PIB, UCB, CVT, TIOT, 
e Attributes: Reenterable 


e Control Sections: IEFDSOWR 


IEFIDMPM: Termination -- Message Module 


This routine contains the messages used by 
the Indicative Dump routine. 


e Entry: IEFIDMPM 


e Attributes: Non-executable % 


e Control Section: IEFIDMPM 





IEFKIMSG: I/0 Device Allocation -- Message 
Module 


This routine contains the messages issued 
by volume attribute setting routine 
IEFPRES. 


e Entry: IEFK1MSG 
e Attributes: Non-executable 


e Control Section: IEFK1iMSG 
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This routine searches a queue for a named 
job or list of named jobs, and can return 
information, or dequeue or cancel the job. 


e Entry: LOCDQ, LOCCAN, LOC 
® Exit: Return to caller 


e Tables/Work Areas: OCR, LYfH 
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e External References: IEFCNVRT, 
ITEFRDWRT 





IEFMCVOL: 1/0 Device Allocation -- Mount 
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Control-Volume Routine 


This routine will have a control volume 
mounted when a data set called for in a job 
step cannot be located on any currently 
mounted control volume. 


e Entries: IEFCVOL1, IEFCVOL2, LTEFCVOL3 


e Exits: IEFVM1, IEFVMCVL, IEFVM6, IEFYN 
(IEFW41SD) 





e Tables/Work Areas: LCT, JCT, SCT, 
SIOT, JFCB, VOLT, QMPA, UCB 


e Attributes: Reusable 


e Control Sections: IEFCVOL1, IEFCVOL2, 
IEFCVOL3 


IEFORMAT: Queue Management -- Queue 
Formatting Routine 


This routine places the work queue data set 
in the format required by the MFT queue 
Management routines. 

e Entry: IEFORMAT, from ITEFSD055 

e Exit: Return to IEFSD055 

e Tables/Work Areas: DCB, DEB 


e Attributes: Reusable 


® Control Section: IEFORMAT 


IEFPPGM: Initiator -- Problem Program 
Initialization Routine 


This routine prepares for the initiation of 
a problem program specified in a START 
command. 


e Entry: IEFPPGM 
e Exit: XCTL to IEFSD511 


e Tables/Work Areas: CSCB, JCT, LOT, 
PIB, SPIL, TCB 


e Attributes: Read-only, reenterable 


® Control Section: IEFPPGM 


IEFPRES: I/O Device Allocation -- Volume 
Attribute Setting Routine 

This routine sets the volume attributes of 
all volumes listed in the PRESKES data set 


and of all unlisted, but permanently 
resident, direct access volumes. 


e® Entry: LEFPRES 


e Exit: To IEEVPRES, IEFSD569, or 
ITEFK1IMSG 


e Tables/Work Areas: UCB 


e Control Section: IEFPRES 


IEFPRINT: Direct System Output -- Tape to 
Printer or Card Punch Routine 


This routine writes a DSO - written tape to 
a printer or card punch. 


e Entry: SPRINTER 
®@ Exit: Return to caller 


e Control Sections: SPRINTER 


IEFQAGST: Queue Management -- Assign/Start 


Routine 


This routine sets up an ECB/IOB and 
prepares the queue manager parameter area 
for the assign routine. 


e Entry: LTEFQAGST 
e Exit: Return to caller 


e Tables/Work Areas: Q/M resident data 
area, QMPA, CVT 


e Attributes: Reenterable 


e Control Section: IEFQAGST 
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IEFQASGQ: Queue Management -~ Assign 
Routine 


This routine assigns records to a queue 
entry and assigns logical tracks as 
reguired. 


e Entry: IEFQASGN 


e Exit: Return to caller 


e Tables/Work Areas: 
area, OMPA, CVT 


O/M resident data 


e Attributes: Reenterable 


e Control Sections: IEFQASGN, IEFQASNM 
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Routine 


This routine inspects the function code in 
the queue manager parameter area and, on 
the basis of this code, branches to the 
appropriate queue management routines. 


e Entry: IEFOQMSSS 
e Exits: To IEFQAGST, IEFQMRAW, 


IEFOMNQOO, or IEFQASGO, return to caller 


e Tables/Work Areas: OQMPA 


e Attributes: Reenterable 


e Control Section: IEFQMSSS 
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Routine 


This routine makes those logical tracks 
assigned to a queue entry available for 
assignment to other queue entries. 


e Entry: IEFQDELE 
°e Exit: 





Return to caller resident data 
area, CVT | ; 


e Attributes: Reenterable 


e Control Section: IEFQDELE 


LEFOMDOO: Queue Management -- Dequeue 
Routine 


This routine removes the highest priority 
entry from an input queue or a system 
Output queue. 


e Entry: IEFQMDQO2 
e Exit: Return to caller 


e Tables/Work Areas: CVT, Q/M resident 


data area, OCR, LTH 
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e Attributes: Reenterable 


e Control section: TEFQMDO 2 


ITEFQMDUM: ueue Management -- Dummy Module 
This routine prevents the occurrence of an 
unresolved external reference to module 
IEFQOMSSS during system generation. 


® Fntry: ITEFQMDUM 


e Attributes: Non-Executable 


e Control Section: IEFQMSSS 


ITEFQMLK1: Queue Management -- Branch 


Routine 


This routine branches to the appropriate 
queue management routine on the basis of an 
assign or read/write function code issued 
by an initiator. 


e Entry: LEFOMSSS. 


e Exits: To IEFQASGQ or IEFQMRAW 


e Tables/Work Areas: QMPA 


e Attributes: Reenterable 


e Control Section: IEFOMSSS 


IEFOMNOO: Queue Management -- Enqueue 
Routine 


This routine places an entry in an input 
queue or an output queue at the requested 
priority. 


e Entry: IEFOMNQ2 
e Exit: Return to caller 


e Tables/Work Areas: CVT, O/M resident 
data area, QMPA, QCR, LTH 


e Attributes: Reenterable 


e Control Section: IEFOMNQO2 


IEFQMRAW: Queue Management -- Read/Write 
Routine 


This routine performs the conversion of a 
TTR into a MBBCCHHR and reads or writes up 
to 15 records of the work queue data set. 


e Entry: IEFQMRAW 
® Exit: Return to caller 


e Tables/Work Areas: Q/M resident data 
area, QMPA, CVT, IOB/ECB 


e Attributes: Reenterable 





e Control Section: IEFOMRAW 
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This routine removes a task from the queue 
Management no-work chain. 


e Entry: IEFOMUNC 
e Exit: Return to caller 


e Tables/Work Areas: CVT, O/M resident 
data area, OCR 


e Attributes: Reenterable 
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e Control Section: IEFOQMUNC 
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Main Storage Reservation Module 


This routine reserves 140 bytes of resident 
main storage for the 
queue-management-opened DCB/DEB and the 
master queue control record at nucleus 
initialization time. 


e Attributes: Non-executable 
e Control Section: IEFJOB 
IEFRCLNi: Restart Reader Linkage 


This routine receives control from IEFVRRC 
and LINKS to interpreter initialization 
routine IEFVH1. 


e Entry: JEFRCLN1 


¢ Exit: XCTL to IEFVRRC at entry 
ITEFVRRCA 


e Attributes: Reenterable 


e Control Section: IEFRCLN1L 


IEFRCLN2: Restart Reader Linkage 
This routine receives control from IEFVRRC 


and LINKS to interpreter initialization 
routine IEFVH1. 
e Entry: IEFRCLN2 


e Exit: XCTL to IEFVRRC at entry 


ITEFVRRCB 
e Attributes: Reenterable 
e Control Section: IEFRCLN2 


IEFRPREP: Termination -- Restart 
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This routine determines whether a job step 
that has been abnormally terminated can be 
restarted. 


e Entry: TEFRPREP from ITEFYNIMP 
e Exit: Return to caller 


e Attributes: Reenterable 


e Tables/Work Areas: LCT, JCT, SCI, Pb9, 
OMPA 


e Control Section: IEFRPREP 


This routine issues the Restart SVC. When 


called by its alias, IEFSMR, it issues the 
Restart SVC and then returns to the caller. 





® Entry: LEFRSTRI, LEFSMR 
e Exit: SVC 52 (RESTART), return to 
caller 


e Attributes: Reenterable 


e® Control Sections: IEFRSTRi 


IEFSDXXX: System Output Writer -- Spanned 
Data Sets Handler 


This routine handles variable-length data 
sets by dynamically moving the input 
segments into the output segments. 


e Entry: LEFSDXXX 
e Exit: Return to caller 


e Tables/Work Areas: Control area for 
Spanning, DCB 


e Attributes: Reentrant 


e Control Section: ILIEFSDXXxX 


IEFSDXYZ: System Output Writer -- Command 
Chaining Access Method 


This routine simulates the processing 
performed by the QSAM Put Locate and 
Truncate routines by using command chaining 
to write one string of up to nine buffers 
with a single IOB and a single EXCP macro 
instruction. 


e Entry: LEFSDXYZ 
e Exit: Return to caller 


e Tables/Work Areas: ECB, IOB, I/0 table 
e Attributes: Reentrant 


e Control Section: IEFSDXYZ 


Appendix Bs MFT Modules 131 
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Interface Routine 


This routine provides an interface between 
the termination entry routine and system 
output processing. 


e Entry: IEFSDO17 


e Exit: To IEFSD429 


e Control Section: I#FSD0i7 


IEFSD055:;__Queue Management -- Queue 
initialization Routine 


This routine constructs a resident DEB/DCE, 
passes control to the queue formatting 
routine or the first phase of system 
restart, initializes the queue manager 
resident data area, and (if required) 
passes control to the second phase of the 
system restart routine. 


e Entry: IEFSDO55, from [EFQINTZ 
e Exits: To IEFORMAT, IEF300SD, or 
IEF304SD 


e Attributes: Reusable 


e Control Section: IEFSD055 


& 


IEFSDO070: System Output Writer -- Data Set 
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Writer Interface Routine 


This routine passes control to the standard 
data set writer or to the user-supplied 
data set writer routine. 


e Entry: IEFSDO70 
e Exits: To IEFSD087 or user-supplied 


routine via LINK, or to IEFSD171 via 
XCTL 


e Attributes: Reenterable 


e Control Section: IEFSD070 
IEFSD078: System Output Writer -- Linker 
Routine 


This routine determines whether the record 
obtained from the output queue entry is a 
DSB or SMB, and passes control, 
accordingly, to the DSB or SMB processor. 





e Entry: IEFSDO78 
e Exits: To IEFSD085, IEFSD086, or 
IEFSD079 


e Attributes: Reenterable 


e Control Section: IEFSD078 
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IEFSDO79: System Output Writer -- Link to 
Queue Manager Delete Routine 


This routine passes control to the delete 
routine to delete the current output queue 
entry. | 


e Entry: TEFSD079 


-e Exits: To IEFQDELQ and IEFSD082 


e Tables/Work Areas: QMPA 


e® Attributes: Reenterable 


e Control Section: I{EFSD079 


IEFSDO080: System Output Writer -- 
Initialization Routine 


This routine initializes the system output 
writer by obtaining main storage for a 
parameter list and the output DCB, and 
opening the output DCB. 


® Entry: IEFSD080 
e Exit: To ILEFSDO81 


e Tables/Work Areas: DCB, CSCB, TIOT, 


JFCB 


e® Attributes: Reenterable 


® Control Section: IEFSD080 


IEFSDO081: System Output Writer -- Class 
Name Setup Routine 


This routine optains main storage for, and 
initializes, a list of ECB pointers, ECBs, 
and queue management communication 
elements, depending on the system output 
classes specified for the writer. 


e Entry: IEFSD081 

e Exit: To IEFSD082 

e Tables/Work Areas: CSCB, ECB 
e Attributes: Reenterable 

e Control Section: IEFSD081 


IEFSD082: System Output Writer -- Main 
Logic Routine 


This routine obtains main storage for QMPAS 
and internal work areas, dequeues output 
queue entries, checks for operator 
commands, and passes control to the 
appropriate routine. 


e Entry: IEFSD082 
e Exits: IEFSD083, IEFSD0O84, IEFSD0O78 
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e Tables/Work Areas: CSCB, ECB 
e Attributes: Reenterable 


e Control Section: LfFSDO82 
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Processing Routine 


This routine processes MODIFY and STOP 
commands that apply to the writer. 


e Entry: IEFSDO83 
e Exits: To IEFSD081 or IEEVTCTL 


e Tables/Work Areas: CSCB, DCB, QMPA, 
BCb 


e Attributes: Reenterable 
e Control Sections: IEFSD083, IEFSD83M 


IEFSDO84: System Output Writer -- Wait 
Routine 


This routine waits for an entry to be 


enqgueued in an output queue corresponding 
to a class available to the writer. 


e Entry: IEFSDO84 

e Exit: To IEFSDO82 

e Attributes: Reenterable 

e Control Section: IEFSD084 


IEFSDO085: System Output Writer -- DSB 
Handler Routine 


This routine initializes for data set 
processing, and informs the operator of the 
pause option in effect. 
e Entry: IEFSDO085, IEFO85SD, or IEF850SD 
e Exit: To IEFSD171 


e Attributes: Reenterable 


e Control Sections: I1EFSD085, IEFSD85M 


Handler 


This routine initializes for message 
processing, and extracts each message from 
the current SMB. 


e Entry: IEFSD086, IEFO86SD 


e Exits: To IEFSD088, IEFSD089, 


IEFQMNOQ, IEFQMRAW, IEFSD085, IEFSD078 


e Tables/Work Areas: SMB, UCB, QMPA, 
TIOT, CSCB, TCB 


e Attributes: Reenterable 


e Control Sections: IEFSD086, IEFSD86M 


IEFSDO87: System Output Writer -- Standard 


Writer Routine 

This routine gets records from a data set. 
e Entry: IEFSDO87 

e Exits: To IEFSD088, IEFSD089, IEFSDO78 

e Tables/Work Areas: DCB 


e Attributes: Reenterable 


e Control Sections: IEFSD087, IEFSD87M 


IEFSDO88: System Output Writer -- 


Transition Routine 
This routine handles the transition between 
messages and data sets, and between data 
sets. 

e Entry: ITEFSD088 

e Exit: To IEFSDO89 

e Tables/Work Areas: DCB 


e Attributes: Reenterable 


e Control Section: IEFSDO88 


IEFSD089: System Output Writer -- Put 
Routine 


This routine formats records as required 
and issues PUT macro instructions to write 
them on the output unit. 


e Entry: IEFSD089 

e Exit: To IEFSD088 

e Tables/Work Areas: DCB 
e Attributes: Reenterable 


e Control Sections: IEFSD089, IEFSD89M 


IEFSDO94: System Output Writer -- Job 
Separator Routine 


This routine prints or punches a job name 
and system output class designation on the 
writer's output device. 

e Entry: IEFSDO94 


e Exits: Io IEFSD088, IEFSDO89, 
IEFSD095, IEFSD0O78 


e Attributes; Reenterable 


® Control Section: IEFSDO94 
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TEFSD095: System Output Writer -~ Print 
Line Routine 

This routine constructs the block letters 
used to separate jobs processed by a system 
output writer when the output data set is 
to be printed. 


e Entry: IEFSDO95 
e Exit: Return to caller 


Reenterable 
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e Control Section: IEFSD095 
IEFSD096: System Output Writer -- Message 
Module 


This routine contains message headers and 
texts for messages to the operator. 


e Entry: IEFSD096 


® Attributes: Non-executable 


e Control Section: IEFSD096 


TEFSD097: I70 Device Allocation ~~ Wait 
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This routine makes the decision whether to 
wait for direct access space, and provides 
an interface with the I/O device allocation 
Space request routine so that retry and 
additional recovery passes may be made. 


e Entry: IEFSD097 
e Exit: Branch on register 14 


e Tables/Work Areas: LCT, TIOT, UCB 


e Attributes: Read-only, reenterable 
e Control Section: IEFSD097 
IEFSD167: Initiator -- Linkage to IEFSD168 


This routine passes control via an XCTL 
Macro instruction to IEFSD168 in the 30K 
scheduler. 


e Entry: IEFSD068 

e Exit: MIEFSD168 

e Tables/Work Areas: None 

e Attributes: Reenterable 

e Control Section: IEFSD068 
IEFSD168: Initiator -- Job Suspension 


This routine causes a terminated job to be 
reenqueued so that the job can be 
reactivated. 
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e Entry: IEFSD068 
, 
e Exit: Branch to IEFSD598 to purge : 


resources, branch to IEFSD510 to Si 
reinitiate job, link to IEFDSOFB 


® Tables/Work Areas: 
SCD, SCT 


OMPA, LCT, JCT, 


e Attributes: Reenterable 


e Control Section: IEFSD068 


e External Reference: 
IEFOMNO2, IEFVSDRA 


ITEFOMRAW, 


IEFSD171: System Output Writer -- Data Set 
Delete Routine 


This routine obtains records from an output 
queue entry, and deletes system output data 
sets. 
e Entry: IEFSDO71 
® Exits: To IEEVLOUT, IEFQOMNQ2, 
IEF850SD, IEFO86SD, IEFSDO78, or 
IEFQMRAW 


® Tables/Work Areas: DCB, SMB, UCB, CVT, 
QMPA, TIOT, CSCB, TCB 


e@ Attributes: Reenterable 
e® Control Sections: IEFSDO71, IEFSD71M 
IEFSD1i95: I/O Device Allocation -- Wait 


for Deallocation Routine 


This routine provides the I/O device 
allocation routine with the ability to wait 
for deallocation to occur during the 
execution of another task, when allocation 
cannot be completed because of current 
allocations. 


e Entry: IJLEFVAWAT 

e Exit: Return to caller 

e Tables/Work Areas: JCT, SCT, SIOT, 
LCT, ECG, CSCB 

e Attributes: Read-only, reenterable 

e Control Section: IEFSD095 


IEFSD210: I/0 Device Allocation -- 
Allocation Entry Routine 


This routine provides an interface for 

entry to the I/O device allocation routine 
operating in a multiprogramming \. 
environment. 





e Entry: IEFW21SD — 
e Exits: To IEFVK, IEFVM or IKFWD00O 


e Tables/Work Areas: JCT, LCT, SCT, SMB, 
QMPA, CVT 


e Attributes: Read-only, reenterable 


® Control Section: IEFWLISD 


eR ae AE ES ES ED Ac 


Terminate #xit Routine 


This routine provides an interface between 
the termination routine and the step delete 
Or alternate step delete routine when a 
step has been terminated. 


e Entry: ILEFW22sS)D 


* Exit: Return to caller of termination 
routine 


e Tables/Work Areas: JCT, SCT, SMB, LCT, 
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QMPA, CB 


e Attributes: Read-only, reenterable 
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e Control Section: ITEFW22°SD 
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This routine reads ail QCRs and logical 
track header records into main storage, 
builds tables A, B, and C, and removes from 
Table A all the LTH entries corresponding 
to logical tracks in the free-track queue 
Or in one of the other queues. 


e Entry: IEFSD300 
e Exit: To LIEFSD301 


e Tables/Work Areas: System restart work 
area, Table A, Tabie B, Table C 


e Attributes: Reenterable 
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e Control Section: IEFSD300 
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This routine searches Table A for the last 
LTH corresponding to each queue entry, 
determines the type of entry, and 
constructs the purge queue. 


e Entry: IEFSD301 


e Exit: To IEFSD302 


e Tables/Work Areas: System restart work 
area, Table A, Table C purge queue, 
interpreter jobnames table 

e Attributes: Reenterable 


e Control Section: ILZEFSD301 


TEFSD302: System Restart -- Jobnames 
Tables Routine 


This routine removes from Table A all 
logical tracks assigned to dequeued input 
or RJE queue entries, and builds a table of 


jobnames for incomplete input and RJE queue 
entries and dequeued input queue entries. 


e Entry: IEFSD302 

e Fxit: To IEFSD303 

e Tables/Work Areas: System restart work 
area, Table A, Table C, and the 
interpreter/initiator jobnames table 


e Attributes: Reenterable 


e® Control Section: TEFSD302 


IEFSD303: System Restart -- Delete Routine 
This routine creates a queue entry of the 
remaining logical tracks and deletes that 
entry, thus assigning those tracks to the 
free-track queue. 

e@ Entry: IEFSD303 


® Exits: Return to caller 


e Tables/Work Areas: System restart work 
area, QMPA, Table A 


e Attributes: Reenterable 


e Control Section: IEFSD303 


ITEFSD304: System Restart -- Scratch Data 
Sets Routine 


This routine informs the operator of the 
names of jobs being processed by an 
interpreter, and scratches temporary data 
sets generated for incomplete input queue 
entries. 

e Entry: IEFSD304 

e Exits: To IEFSD0O55, IEFSD308 


e Tables/Work Areas: CVT, UCB address 
look-up table 


e Attributes: Reenterable 


e Control Section: IEFSD304 
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TEFSD305: System Restart -- Reenqueue 
Routine 


This routine degueues the entries in the 
purge queue and reenqueues them in the 
appropriate input or output queue and 
informs the operator of the names of jobs 
in the process of initiation. 


e Entry: IEFSD305 


e Exit: IEFSD304 


e Tables/Work Areas: System restart work 


area, purge queue, JCT, SCT, JFCE, DSB, 
SCD, S1OT. 
e Attributes: Reenterable 
e Control Section: IEFSD305 
IEFSD308: System Restart -- Scratch Data 
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This routine scratches the temporary data 
sets generated for incomplete input queue 
entries. 


e Entry: IEFSD308 
e® Exit: Return to caller 


e Tables/Work Areas: 
CVT, VIOC, DEB 


DSCB, DCB, UCB, 





e Attributes: Reenterable 
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* Control Section: IEFSD308 
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Termination Exit Routine 


This routine provides an interface between 
the termination routine and the step delete 
Or alternate step delete routine when the 
last step of a job has been terminated. If 
DSO was used, the DSOCBs are released; if 
the message class is assigned to DSO, the 
routine links to IEFDSOWR. 


e Entry: IJEFW31SD 


e Exit: IEFSD320 (44K Scheduler), 
IEFSD339Q (30K Scheduler), or IEFDSOWR 

e Tables/Work Areas: JCT, SCT, SMB, 
OMPA, ECB, CVT, M/S resident data area, 
DSOCB, PIB 

reenterable 


e Attributes: Read-only, 


e Control Section: IEFW31SD 


IEFSD310: System Restart -- TTR and NN to 
MBBCCHHR Conversion Routine 


This routine converts a relative record 
address (NN) or a relative track and record 
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address (TTR) to an actual disk address 
(MBBCCHHR). 


e Entry: LEFSD310 
e Exit: Return to caller 


e Tables/Work Areas: CVT 


e Attributes: Reenterable 


e Control Section: IEFSD3i10 


IEFSD311: Queue Management -- Message 
Module 


This routine contains the messages required 
by the queue initialization routine 
(ITEFSDO055). 


e Entry: IEFSD311, SD55MSG1, SD55MSG2, 


SD55MSG3 


e Attributes: Non-executable 


e Control Section: IEFSD311 


IEFSD3i2: System Restart -- Message Module 


This routine contains the messages required 
by the system restart routines. 

e Entry: IEFSD312, SD304MG1, SD304MG2, 
SD305MG1 


e Attributes: Non-executable 


e Control Section: IEFSD312 


IEFSD320: Initiator -- Linkage From Job 


Termination to the Initiator for the 44K 
Scheduler 


This routine receives control from job 
termination exit routine IEFSD310 in MrT 
systems with the 44K scheduler. It returns 
control to step deletion routine IEFSD515 
via the RETURN macro instruction. 


e Entry: ITEFW32SD 


e Exit: Return to IEFSD515 


* Tables/Work Areas: None 


e Attributes: Reenterable 


e Control Section: IEFW32SD 


IEFSD33Q: Initiator -- Linkage From Job 


Termination to the Initiator for the 30K 
Scheduler 


This routine receives control from job 
termination routine IEFSD31Q0 in MFT systems 
with the 30K scheduler. It passes control 
to job deletion routine IEFSD517 with the 





address of the Life-of-Task block in 
register 1. 


e Entry: IEFW32SD 


e® Exit: Branch to IEFSD517 


e Tables/Work Areas: None 


e Attributes: Reenterable 
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e Control Section: IBFW32SD 
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LTEFSD41Q: I/0 Device Allocation -- 
Allocation Exit Routine 








This routine provides an interface for exit 
from the I/O device allocation routine 
Operating in a multiprogramming 
environment. 


e Entry: IEFW41SD, IEFWIFAK, IEFW2ZFAK 
e Exits: To IEFVM, or return to caller 


« Tables/Work Areas: ATCA, JCT, LCT, 


MVA, MVAX, SCT, SMB, QMPA 
reenterable 


e Attributes: Read-only, 


e Control Section: IEFW41SD 


IEFSD42Q: Termination Routine -~ 
Termination Entry Routine 


This routine provides an interface for 
entry to the termination routine operating 
in a multiprogramming environment. it also 
provides an interface for entry to the LOG 
function if a LOG data set is scheduled to 
be added to the SYSOUT queue. 


e Entry: IEFW42SD 


e Exit: To IEFYN 


e Tables/Work Areas: 
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CT, SCT, SMB, LCT, 


Read-only, reenterable 


e Control Section: IEFW42SD 
ITEFSD510: Initiator -- Job Selection 
Routine 


This routine selects a system or problem 
program job. This module executes only in 
a large (scheduler-size) partition. 


e Entry: IEFSD510 
e Exits: Branch to IEFSD511 or IEFSD515, 


LINK to IEFSD519, XCTL to IEFSD586, 
IEFSD589, SMALTERM 


e Tables/Work Areas: LOT block, CSCB, 
SPIL, CVT, TCB, PIB, DSOCB 





e Attributes: Read-only, reenterable 


e Control Sections IEFSD510 


* External References: IEFQOMDOO, 
ITEFQMUNC 
IEFSD511: Initiator -- Job Initiation 
Routine 


This routine initializes information 
pertaining to a job. if DSO is available 
for the job's system output classes, the 
routine selects the DSOCBs to be used by 
the job. 


e Entry: ITEFSD511, IEFDSOSL 
e Exit: Branch to IEFSD541 


e Tables/work Areas: 
CSCB, JCT, SCT, SCD, PIB, 


Life-of-Task Block, 
IOB2, DSOCB 


e Attributes: Read-only, Reenterable 


e Control Section: IEFSD511, IEFDSOSL 


e External References: IEFOMRAW 


IEFSD512: Initiator -- Step Initiation 
Routine 


This routine passes control to allocation 
aS a closed subroutine via an XCTL macro 
instruction and receives control back from 
Allocation at entry point IEFALRET. If an 
allocation error occurs, it passes control 
to the Alternate Step Deletion routine. 
Otherwise, it continues normally and 
schedules a job step. 


e Entry: IEFSD512, IEFALRET 
e Exits: Branch to IEFSD513, IEFSD516, 


or ITEFSD518, XCTL to IEFSD510, IEFSD556 


e Tables/Work Areas: LOT Block, JCT, 
SCT, APL, TIOT, IOB1, IOB2, QOMPA, SMB, 
DSOCB 

e Attributes: Read-only, reenterable 


e Control Section: IEFSD512 


e External References: IEFOMRAW, 
IEFSD556, IEFSD514, IEFDSOWR 


IEFSD513: 
interface 


Initiator -- Problem Program 


This routine prepares the partition for 
problem program execution by moving the 
TIOT to the highest available storage area. 


The routine also opens JOBLIB and FETCH 
DCBs, if required. A final check is made 
to determine if a CANCEL command has been 
received for the job before the problem 
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program is brought into the partition and 
given control. If scheduling was performed 
for a small partition, IEFSD513 
communicates with the small partition. 
e Entry: IEFSD513 
e Exits: XCTL to problem program, ABEND, 
or to LEFSD510 


e Tables/Work Areas: LOT Block, Transfer 
Parameter List, TIOT, User's Parameter 
List, TCB, CVI, PIB, CSCB, SPIL, APL, 
JCT, SCT; -DCB 


*® Attributes: Read-only, reenterable 


e Control Section: IEFSD513 
TEFSD514: Queue Management -- Figure 


Breakup Routine 


This routine reads and writes tables which 
may be required by the job scheduler. The 
routine breaks the tables into 176-byte 
records, writes the records on disk, and 
retrieves the records from disk to 
reconstruct the tables in main storage. 


e Entry: IEFSD514 


e Exit: Return to caller 


e Tables/Work Areas: QMPA, TBR Parameter 


List 
e Attributes: Read-only, reenterable 
e Control Section: IKFSD5i4 
e External References: IEFQASGN, 
ITEFOMRAW 
IEFSD515: Initiator -- Step Deletion 
Routine 


This routine retrieves the TIOT and 
Life-of-Task Block from disk, reads in the 
JCT and SCT, and branches to termination, 
which is used as a closed subroutine. It 
also reads in the SCT for the next step to 
be scheduled, if required. 


e Entry: IEFSD515, SMALTERM, or GO 
e Exits: XCTL to IEFSD512 or Branch to 


TEFSD517, IEFSD558, IEFSD167 (30K 
Scheduler), IEFSD168 (44K Scheduler), 
or BALR to IEFSD420 

e Tables/Work Areas: lLife-of-Task Block, 
Terminate Parameter List, CVI, TCB, 
PIB, IOB, CSCB, DCB, JCT, SCT, SPIL, 
DSOCB 


e Attributes: Read-only, reenterable 


138 Job Management with MFT (Release 21) 


e Control Section: IEFSD515 
e® External References: IEFOMRAW, 
IEFSD514, ILEFSD420, IEFSD598 


IEFSD516: Initiator -- Alternate Step 
Deletion Routine 7 


This routine provides an interface with 
termination when an allocation error occurs 
during step initiation. Termination is 
used as a closed subroutine. If required, 
this routine reads the SCT of the next step 
to support job flushing. 


e Entry: IEFSD516 
® Exits: Branch to ITEFSD51i2 or IEFSD517 


e Tables/Work Areas: lLife-of-Task block, 
CSCB, Terminate Parameter List, SCT 
e Attributes: Read-only, reenterable 


® Control Section: IEFSD516 


® External References: IEFOMRAW, 
ITEFS D420 
TEFSD517:3 


Initiator -- Job Deletion 
Routine . 


This routine deletes the disk queue entry 
for a terminated job and unchains and 
deletes the CSCB for the job. 


e Entry: LEFSD517 
e Exit: Branch to IEFSD5i0 


® Tables/Work Areas: 
block, SPIL 


CSCB, Life-of-Task 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD517 
e External References: IEFQDELE, 
IEFSD598 
IEFSD518: Initiator -- Partition Recovery 
Routine 


This routine determines the status of main 
storage required for a checkpoint/restart. 


e Entry: IEFSD518 
e Exits: Return to IEFSD512 


e Tables/Work Areas: SPIL, CVT, TCB, 
JCT, PIB, LOT, QMPA, CSCB, DSOCB 
e Attributes: Reenterable 


e Control Section: LEFSD518 





e External Reference: IEFQOMRAW, 
ITEFOMNY2, IEFSD598, ITEFDSOFB 
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This routine builds a seven-word parameter 
list used py IEFLOCDQ to locate a job by 
jobname on the checkpoint/restart internal 
queue. 


e Entry: IEFSD519 

e Exit: Return to IEFSD510 

e Tables/Work Areas: LOT, PIB 
e Attributes: Reenterable 

e Control Section: IEFSD519 
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e External Reference: IEFLOCDO, ITEFOMRAW 
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Suspend rene 
This routine closes the reader input data 
set and procedure library, and saves data 
reguired to restore the reader. 

e Entry: IEFSD530 


e Exit: Return to caller 


e Tables/Work Areas: IWA, TIOT, LWA, 
OMPA, CVT, UCB, MSRC, PIB, CSCB 





e Attributes: Read-only, reenterable 
e Control Section: IEFSD530 


e External References: IEFSD514, IEF- 


OMRAW, IEFJASNM, TEFQASGN 


IEFSD531: Interpreter -- Transient Reader 
Restore _ Routine 


This routine restores the information 
required to "restart" a transient reader 
after it has been suspended. It reopens 
the reader input data set and procedure 
library. 


e Entry: IEFSD531 
e Exit: XCTL to IEFVHCB 


e Tables/Work Areas: IWA, TIOT, OMPA, 
CVT, UCB, MSRC, PIB, CSCB 





e Attributes: Read-only, reenterable 
e Control Sections: IEFSD531, IEFPH2 


e External References: IEFSD514, IEF- 
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OMRAW, ITEFQJASNM, IEFQASGN 


ITEFSD532:; Interpreter -- Transient Reader 
Suspend Tests 


This routine determines the status of a 
transient reader. IEFSD532 receives 
control from IEFVHH after a job has been 
enqueued. 


e Entry: LEFKG 


e Exits: xXCIrL to ITEFVHN or IEFSD530, or 
branch to IEFVHHB 





e Tables/Work Areas: IWA, LWA, QMPA, 
PIB, CVT 


e Attributes: Read-only, reenterable 


e Control Section: IEFKG 


LEFSD533: Interpreter -- Interface Routine 
This routine provides an interface between 
the reader/interpreter and system task 
control. 

e Entry: IEFIRC 


®* Exits: XCIL to LIEFSD537. RETURN to 
STC if error. 


e Tables/Work Areas: CSCB, CVT, QMPA 
e Attributes: Reenterable, read-only 
e Control Section: IEFIRC 
ITEFSD534;3 System Task Control -- LPSW 
Routine 


This routine places system task control in 
problem program mode by loading a PSW. 


e Entry: ITEFSD534 
e Exit: xXCTL to IEEVSTAR 
e Tables/Work Areas: None 


e Attributes: Reenterable 


e Control Section: IEFSD534 


IEFSD535: System Task Control -- LPSW 
Routine 


This routine places system task control in 
the problem program mode by loading a PSW. 


e Entry: IEFSD535 
e Exit: XCTL to IBEVTCTL 
e Tables/Work Areas: None 


e Attributes: Reenterable 
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e Control Section: IEFSD535 


LEFSD536: Interpreter -~- Operator Message 
Routine 


This routine writes a message to the 
Operator when an I/O error or CPO full 
condition has occurred. The routine also 
sets proper indicators to cause a cleanup 
of the current job. 


_ @ Entry: ITEFVHR 


e Exits: Return to caller, XCTL to 
IEFVHN, or LINK to LEFSD308 


T k Are IWA, JCT, LWA, UCB, 
CVT, PIB, CSCB, Master Scheduler 
resident data area 

reenterable 


e Attributes: Read-only, 


e Control Section: IEFVHR 


IEFSD537: Interpreter -- Linkaye Module 


This routine provides an interface between 
System task control anda reader. It also 
frees the interpreter entrance list (NEL) 

and associated areas if a reader is being 

terminated or suspended. 


e Entry: IEFSD537 
e Exits: LINK to IEFVH1, or IEFSD531, or 


Return to system task control 
e Tables/Work Areas: “NEL 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD537 
IEFSD540: Initiator -- Linkage to IEFSD541i 


This routine provides an interface linkage > 
to IEFSD541 via an XCTL macro instruction. 


e Entry: i1EFSD540 


e Exit: XCTL to IEFSD541 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD540 


ITEFSD541: Initiator -- Data Set Integrity 
This routine enqueues on explicit data sets 
and thus prevents concurrent, and 
impairing, access between tasks. 


e Entry: IEFSD541 
e Exit: Branch to IEFSD512 
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e Tables/Work Areas: LOT Block, IOBi, 
IOB2, JCT, SCT, CSCB, SPIL, DSENQ 
Table, Minor Name List, ENQ supervisor 
list. 


e® Attributes: Read-only 


e Control Section: IEFSD541 


e External References: IEFOMRAW 


IEFSD551: 
to TEFXJIMP 


This routine provides an interface linkage 
to IEFXJIMP via an XCTL macro instruction 
in the 30K design package. 


e Entry: IEFV1I5xXL 
e Exit: XCTL to ITEFXJIMP 


@® Tables/work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFV15XL 


IEFSD552: I/O Device Allocation -- Linkage 
to LTEFXJIMP 


This routine provides an interface linkage 
to IEFXJIMP via an XCTL macro instruction 
in the 30K design package. 


e Entry: IEFXJX5A 
e Exit: xXCTL to IEFXJIMP 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFXJX5A . 


IEFSD553: Initiator -- Linkage to ITEFSD512 


This routine provides a linkage to IEFSD512 
via an XCTL macro instruction. 


e Entry: ILEFSD512 
e Exit: xXCTL to IEFSD512 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD512 


IEFSD554: Initiator -- Linkage to IEFSD516 


This routine provides a linkage to IEFSD516 
via an XCTL macro instruction. 


e Entry: IEFSD554 





e Exit: XCTL to IEFSD516 
e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 
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e Control Section: IEFSD554 


This routine provides linkage to ITEFSD510 
via an XCTL macro instruction. 


e Entry: IEFSD555 

e Exit: XCTL to IEFSD510 

e Tables/Work Areas: Same as caller. 
e Attributes: Read-only, reenterable 
e Control Section: IEFSD555 


TEFSD556: Initiator -- Set Problem Program 
state Return 





This routine establishes the allocation 
routine ina problem program state, upon 
entry. 


e Entry: IEFSD556 

e Exit: LPSW to IEFW21SD 

e Tables/Work Areas: Same as caller. 
e Attributes: Read-only, reenterable 


e Control Section: IEFSD556 


IEFSD557: I/0 Device Allocation -- 
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Interface Routine 


This routine provides an interface between 
system task control and allocation. 


e Entry: IEFW21SD 
e Exit: IEFWSD21 


e Tables/Work Areas: ECB, IOB 
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e Attributes: Reenterable 
e Control Section: IEFSD557 
TEFSD558: Initiator -- Linkage to IEFSD5i1 


This routine provides a linkage to IEFSD511 
via an XCTL macro instruction. 


e Entry: IEFSD558 
e Exit: IEFSD511 


e Attributes: Read-only, reenterable 


e Control Section: IJIEFSD558 


IEFSD559:; Initiator -- Linkage to IEFSD515 


This routine provides a linkage to IEFSD515 
via an XCTL macro instruction. 


e Entry: SMALT ERM 


e Exit: IEFSD515 
e Attributes: Read-only, reenterable 


e Control Section: ILIEFSD559 


IEFSD567: Nucleus -- I/O Device Allocation 


Device-End Interrupt Handler Routine 


This routine handles the posting of 
unsolicited device interruptions for I/0 
device allocation operating ina 
multiprogramming environment. 


e Entry: LEFDPOST 


e Exits: IEAOPTO1 or return to caller 
e Tables/Work Areas: ATCA, MVA, MVAX 
e Attributes: Disabled, resident 

e Control Section: *ITEFDPOST 


IEFSD569: Master Scheduler -- 
Initialization Routine 


This routine initializes the communications 
task and the system log. It issues the 
READY message and formats the job queue, as 
well as typing out the automatic commands 
and invoking processing of the automatic 
commands. This routine establishes 
partitioning of main storage at system 
initialization and readies the partitions 
for the START command. It is called out at 
system generation by the macro, SGIEEOVV. 


e Entry: IEFSD569 


e Exit: IEEOQ503D, Branch to dispatcher 
e Attributes: Read-only, non-reenterable 


e Control Section: IEFSD569 


IEFSD572: Queue Management -- Interpreter/ 
Queue Manager Interlock Routine 


This routine determines if a possible 
interlock condition exists between the 
queue manager and the reader. The routine 
issues a message requesting the operator to 
reply with either WAIT, to wait for space 
to be freed, or CANCEL, to cancel the job. 


e Entr ILEFSD572 
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e Exits: ABEND, or return to caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD572, IEFSD573 
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TEFSD584; System Task Control -~ LPSW 
Routine 


This routine places system task control in 
the problem program mode by loading a PSW. 


e Entry: IEFSD584 

e Exit: XCTL to IEESD591 

e Control Section: IEFSD584 
IEFSD585:__ System Task Control -- LPSW 


Routine 


This routine pliaces the DSO processor in 
the problem program mode by loading a PSW. 


e Entry: IEFSD585 
e Exit: XCTL to IEFDSOSM 


e Control Section: IEFSD585 
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to IEFSD585 


This routine links to IEFSD585 so that upon 
return the initiator will be in supervisor 
State. 


e Entry: IEFSD586 
e Exit: Link to IEFSD585 
e Control Section: IEFSD586 
TEFSD587: System Task Control -- Linkage 





to IEFSD535 


This routine provides a linkage to IEFSD535 
via a LINK macro instruction, so that upon 
return the initiator will be in the 
Supervisor state. 


e Entry: IEFSD587 


e Exit: Link to IEFSD535, XCTL to 
IEFSD510 

e Attributes: Read-only, reenterable 

e Control Section: IEFSD587 


IEFSD588: System Task Control -- Linkage 
to IEE591SD 


This routine links to IEE591SD to bring the 
Suspended reader into the assigned 
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partition so that upon return, the 
initiator will be in supervisor state. 


e Entry: l1EFSD588 


e Exit: XCTL to IEFSD510 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD588 


LEFSD589: System Task Control -- Linkage 
to IEFSD534 


This routine links to IEFSD534 so that upon 
return, the initiator will be in supervisor 
state. 


e Entry: TEFSD589 
e Exits: LINK to IEFSD534, XCTL to 


IEFSD510 or IEFPPGM 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD589 


IEFSD597: Initiator -- Shared DASD ENQ/DE9Q 
Purge Routine 


This routine is the purge routine for 
systems that include the shared DASD 
feature. In addition to purging all 
resources enqueued by a job step, but not 
dequeued, IEFSD597 also releases reserved 
devices. 


e Entry: ITEFSD598 


e Exit: Return to caller 


e Tables/Work Areas: Major QCB, Minor 
OCB, QEL, TCB, SVRB, CVT, ABTERM 


e Attributes; 
disabled 


Read-only, reenterable, 


e Control Section: IEFSD598 


IEFSD598: Initiator -- ENO/DEQ Purge 


Routine 


This routine purges all resources enqueued 


by a job step, but not dequeued. 


e Entry: IEFSD598 
e Exit: Return to caller 


e Tables/Work Areas: Major QCB, Minor 
OCB, QEL, TCB, SVRB, CVT, ABTERM 


e Attributes: 
disabled 


Read-only, Reenterable, 





* Control Section: IEFSD598 


IEFSD599: Initiator -- Small Partition 
Module 

This routine provides an interface with the 
scheduler in a large partition to initiate 
and terminate small partitions. 


e Entry: IEFSD599, SMALLGO 
e Exits: ABEND, or XCTL to IEF589SP or 
ITEFSD586 


e Tables/Work Areas: SPIL, allocate 


parameter list (APL), DSOCB, PIB 
reenterable 


e Attributes: Read-only, 


e Control Section: IEFSD599 


e External Reference: IEFQMUNC 


IEFSMFAT: Initiator -- TCTLOT Construction 


ae tet eee a rm 


This routine constructs the TICTIOT, appends 
it to the TCT, initializes the TCT storage 
map, and stores the user routine address in 
the TCT. | 


e Entry: IEFSMFAT 
e Exit: Return to caller 


e Tables/Work Areas: 


TCT, TCTIOT, TIOT 


POE, SMCA, TCB, 





e Attributes: Reentrant 
e Control Sections: IEFSMFAT 
IEFSMFIE: Initiator -- User Exit 
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This routine initializes the parameter 
lists for the Job Initiation and Step 
initiation user exits. 


e Entry: JIEFSMFIE 
e Exit: Return to caller 


e Tables/Work Areas: 


Jct, JMR, LCT, SCT, 


e Attributes: Reentrant 


e Control Sections: IEFSMFIE 
LEFSMFLK: 
Initialization Routine 





This routine initializes the parameter 
lists for the Job Termination and Step 
Termination user exits. 


Termination Routine -- User Exit 


e Entry: LEFACTLK 
e Fxit: Return to caller 


® Tables/work Areas: 
SMCA, TCB, TCT 


JCT, JMR, LCT, SCT, 


e Attributes: Reentrant 


e Control Sections: IEFACTLK 


Termination Routine -- SMF 


LEFSMEFWI : 
Writer Interface Routine 


This routine constructs the SMF job 
termination and step termination records. 


e Entry: LEFSMFWI 
e Exit: Return to caller 


e Tables/Work Areas: JCT, JMR, LCT, SCT 


e Attributes: Reentrant 


e Control Sections: IEFSMFWI1 


IEFUJI: Initiator -- Dummy User Job 
Initiation Exit Routine 


This routine simulates the presence of a 

user-supplied job initiation exit routine. 
e Entry: ILEFUJI 

e Exit: Return to caller 


e Attributes: Reentrant 


e Control Sections: IEFUJI 


IEFUJV: Interpreter -- Dummy User JCL 
Validation Exit Routine 


This routine simulates the presence of a 
user-supplied JCL validiation routine. 


e Entry: LEFUJV 
e Exit: Return to caller 


e® Attributes: Reentrant 


e Control Sections: IEFUJV 


IEFUSI: Initiator -- Dummy User Step 
Initiation Exit Routine 


This routine simulates the presence of a 

user~-supplied step initiation exit routine. 
e Entry: IEFUSI 

e Exit: Return to caller 


e Attributes: Reentrant 
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e Control Sections: IEFUSI 
IEFVDA: Interpreter -- DD Statement 
Processor 


This routine constructs and adds entries to 
a JFCB and SIOT from the complete logical 
DD statement in the internal text buffer. 


ITEFVDA 


e Entry: 
e Exit: To LEFVHF 


e Tables/Work Areas: 
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JFCB, JCB, SCT 


IWA, LWA, SIOT, 


e Attributes: Read-only, reenterable 


e Control Section: IEFVDA 
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This routine creates a data set name table. 


e Entry: ILEFVDBSD 

e Exit: To IEFVDA 

e Attributes: Reenterable 

e Control Section: IEFVDBSD 
IEFVEA: Interpreter -- EXEC statement 
Processor 


This routine constructs or updates an SCT, 
and, if necessary, a joblib JFCB and SIOT 
from the complete logical EXEC statement in 
the internal text buffer. 


e Entry: IEFVEA, from IEFVFA 
e Exit: To IEFVHF, IEFVINB 


e Tables/Work Areas: IWA, EXEC work 
area, interpreter key table, JCT, SCT, 
SIOT, QMPA, procedure override table, 
DCBD, PARMLIST, WORKAREA 


e Attributes: Read-only, reenterable 


e Control Section: IEFVEA 
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IEFVFA: pueereeeten. a: Scan Routine 

This routine scans the card image of a JOB, 
EXEC, or DD statement, performs error 
Checking of JCL syntax, builds internal 
text, and, when a complete logical 
statement (including continuations and 
Overrides) has been scanned, passes control 
to the appropriate statement processor. 


e Entry: LTEFVFA 
e Exits: To IEFVGM, IEFVHO, IEFVHF, 


IEFVJA, IEFVDA, IEFVEA 
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e Tables/Work Areas: IWA, scan routine 
work area, interpreter key table, QMPA, 
internal text buffer, scan dictionary. 


e Attributes: Read-only, reenterable 


® Control Section: IEFVFA 


IEFVFB: Interpreter -- Symbolic Parameter 
Processing Routine 


This routine processes symbolic parameters 
by creating symbolic parameter table buffer 
entries to assign values to symbolic 
parameters, and extracts those values and 
places them in the intermediate text buffer 
when a symbolic parameter is used. 


e Entry: LTEFVFB 
e Exit: Return to caller 


e Tables/Work Areas: IWA, LWA SYMBUF, 
intermediate Text Buffer, QMPA 
e Attributes: Read-only, reenterable 


e Control Section: IEFVFsB 


IEFVGI: Interpreter -- Dictionary Entry 
Routine 


This routine constructs entries for ene 


.refer-oack dictionary. 


e Entry: IEFVGI 
e Exit: Return to caller 


e Tables/Work Areas: Refer-back 
dictionary, auxiliary work area, IWA, 
OMPA 


e Control Section: IEFVGI 


IEFVGK: Interpreter -- Get Parameter 
Routine 


This routine searches the internal text 
buffer for the next parameter, performs 
basic error checking, and passes control to 
the appropriate keyword routine. 


e Entry: IJEFVGK 


e Exit: Return to caller 
® Tables/Work Areas: Local work area, 
IWA, internal text buffer, KBT, PDT. 


e Control Section: IEFVGK 


IEFVGM: Interpreter -- Message Processing 
Routine 


This routine constructs SMBs containing 
interpreter error messages.and JCL 
statement images, assigns space for these 


ESS 


a 





SMBs in the message class output queue 
entry, and writes the SMBs into the entry. 


e Entry: ILEFVGM 
e Exit: Return to caller 


e Tables/Work Areas: QMPA, SMB, SCD, 
IWA, JCT 


e Attributes: Reenterable, character 
dependence type C 


e Control Section: IEFVGM 
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IEFVGM1: Interpreter -- Message Module 


This routine contains interpreter messages 
01-07. 


e Attributes: Non-executable 


e Control Section: IEFVGM1 


IEFVGM2: Interpreter -- Message Module 


This routine contains interpreter messages 
O8-OF. 


e Attributes: Non-executable 
e Control Section: IEFVGM2 


IEFVGM3: Interpreter -- Message Module 


This routine contains interpreter messages 
LOT 


e Attributes: Non-executable 
e Control Section: IEFVGM3 
IEFVGM4:; Interpreter -- Message Module 


This routine contains interpreter messages 
18-1F. 


e Attributes: Non-executable 
® Control Section: IEFVGM4 
IEFVGM5: Interpreter -- Message Module 


This routine contains interpreter messages 
20-27. 


e Attributes: Non-executable 
e Control Section: IEFVGM5 
ITEFVGM6: Interpreter -- Message Module 


This routine contains interpreter messages 
28-2F e 


e Attributes: Non-executable 


e Control Section: ILEFVGM6 


IEFVGM7: Interpreter -- Message Module 


This routine contains interpreter messages 
30-37. 


e Attributes: Non-executable 


e Control Section: JEFVGM7 


ITEFVGM8: interpreter -- Message Module 


This routine contains interpreter messages 
50-57. 


e@ Attributes: Non-executable 


e Control Section: IEFVGM8 


IEFVGM9: Interpreter -- Message Module 


This routine contains interpreter messages 
58-5F. 


e Attributes: Non-executable 


e Control Section: IEFVGM9 


IEFVGM10: Interpreter -- Message Module 


This routine contains interpreter messages 
60-67. 


e Attributes: Non-executable 
e Control Section: IEFVGM10 


IEFVGM11: Interpreter -- Message Module 


This routine contains interpreter messages 
68-6F. 


® Attributes: Non-executable 
e Control Section: IEFVGM11 


TEFVGMi2: Interpreter -- Message Module 


This routine contains interpreter messages 
70-77. 


e Attributes: Non-executable 
e Control Sections IEFVGM12 


IEFVGM13: Interpreter -- Message Module 


This routine contains interpreter messages 
78-7F. 


e Attributes: Non-executable 


e Control Section: IEFVGM13 
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IEFVGM14: Interpreter -- Message Module 


This routine contains interpreter messages 
88-8F. 
e Attributes: Non-executable 


e Control Section: IEFVGM14 


IEFVGM15: Interpreter Message -- Module 


This routine contains interpreter messages 
90-97. 


e Attributes: Non-executable 


e® Control Section: IEFVGM15 


IEFVGM16: Interpreter -- Message Module 


This routine contains interpreter messages 
A0O-A7. 
e Attributes: Non-executable 


e Control Section: IEFVGM16 


IEFVGM17: Interpreter -- Message Module 


This routine contains interpreter messages 
56-5D. 
@® Attributes: Non-executable 


e Control Section: IEFVGM17 


IEFVGM18: Interpreter -- Message Module 


This routine contains interpreter messages 
80-87. 7 
e Attributes: Non-executable 


e Control Section: IEFVGM18 


ITEFVGM19: Interpreter -- Message Module 


This routine contains interpreter messages 
3E-45. 
e Attributes: Non-executable 


e Control Section: IEFVGM19 


ITEFVGM70: Interpreter ~- Message Module 


This routine contains interpreter messages 
38-3F. : 
e Attributes: Non-executable 


e Control Section: IEFVGM70 


ITEFVGM71: Interpreter -- Message Module 


This routine contains interpreter messages 
40-47. 
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e Attributes: Non-executable 


e Control Section: IEFVGM71 


IEFVGM78: Interpreter -- Message Module 


This routine contains interpreter messages 
08-OD. 


e Attributes: Non-executable 


e Control Section: IEFVGM78 


IEFVGS: Interpreter -- Dictionary Search 
Routine 


This routine searches the refer-back 
dictionary for the address of a 
previously-defined SCT, SIOT, or JFCB. 


e Entry: LEFVGS 
e Exit: Return to caller 


e Tables/Work Areas: Auxiliary work 
area, IWA, QMPA, refer-back dictionary 


e Control Section: IEFVGS 


IEFVGT: Interpreter -- Test and Store 
Routine 


This routine performs operations on a 
parameter as indicated in the appropriate 
parameter descriptor table entry. 


e Entry: IEFVGT 
e Exit: Return to keyword routine 


e Tables/Work Areas: Internal text 
buffer, PDT, local work area, IWA 


e Control Section: IEFVGT 


IEFVHA: Interpreter -- Get Routine 


This routine reads statements from the 
input stream and the procedure library. 


e Entry: IEFVHA 
e Exits: IEFVHC, IEFVHB, IEFVHAA, 





IEFSD536, IEFVGM 


e Tables/Work Areas: IWA, JCT, DCB 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHA 


IEFVHAA: Interpreter -- End-of-File 
Routine , : 


This routine determines the conditions 
under which an end-of-file condition has 
occurred, and sets switches and passes 
control accordingly. 





e Entry: LEFVHAA 


e Exits: JIEFVHC or IEFVHN 


Tables/Work Areas: IWA, JCT 


Attributes: Read-only, reenterable 


Control Section: IEFVHAA 


IEFVHB: Interpreter -- DD * Statement 
Generator Routine 


This routine generates a "SYSIN DD *" 
statement for data in the input stream, 
when no such statement was included. 


e Entry: ITEFVHB 


e Exits: To IEFVHC, IEFVHA, IEFVGM 


Tables/Work Areas: IWA, JCT 


Attributes: Read-only, reenterable 


Control Section: IEFVHB 


IEFVHC: Interpreter -- Continuation 
Statement Routine 


This routine determines whether the current 
statement should be a continuation, and, if 
so, determines whether it is a valid 
continuation statement. 

e Entry: ITEFVHC 


e Exits: To IEFVHEB, IEFVHCB, IEFVGM 


Tables/Work Areas: IWA, JCT, DCBD 
e Attributes: Read-only, reenterable 


e Control Section: IEFVHC 


ITEFVHCB: Interpreter -- Verb 
Identification Routine 


This routine identifies the verb ina 
control statement. 


e Entry: ITEFVHCB 


e Exits: To IEFVHE, IEFVHM, IEFVHA, 
IEFVGM, IEFVHL 


e Tables/Work Areas: IWA, JCT, DCBD, 
PARMLIST, WORKAREA 


e Attributes: Read-only, reenterable 
e Control Section: IEFVHCB 


LEFVHE: Interpreter -- Router 


This routine determines the conditions 
under which it was entered, and passes 
control to the appropriate routine. 


e Entry: IEFVHE 

e Exits: To IEFVHEB, IEFVHH, IEFVHEC 
e Tables/Work Areas: IWA 

e Attributes: Read-only, reenterable 


e Control Section: ILIEFVHE 


TEFVHEB: Interpreter -- Pre-Scan 
Preparation Routine 


This routine determines whether a message 
is required or additional work queue space 
is required before a statement is scanned. 
If so, it causes the message to be written 
or the work queue space to be assigned. 


e Entry: IEFVHEB 


e Exits: To IEFVHQ, IEFVGM, IEFVHG, 
TEFVFA 





e Tables/Work Areas: IWA, JCT, SCT, QMPA 
e Attributes: Read-only, reenterable 


e Control Section: IEFVHEB 


IEFVHEC: Interpreter -- Job Validity Check 
Routine 


This routine determines whether an SCT has 
been built for the current job; if not, the 
routine constructs an SCT. 

e Entry: IEFVHEC 

e Exits: To IEFVGM, IEFVHH 

e Tables/Work Areas: IWA, JCT, SCT 

e Attributes: Read-only, reenterable 

e Control Section: IEFVHEC 
IEFVHF: Interpreter -- Post-Scan Routine 


This routine determines the conditions 
under which it was entered, and passes 
control accordingly. 

e Entry: IEFVHF 


e Exits: To IEFVHG, IEFVHEB, IEFVHCB, 
TEFVHA 


e Tables/Work Areas: IWA, CWA 
e Attributes: Read-only, reenterable 
e Control Section: IEFVHF 


IEFVHG: Interpreter -- CPO Routine 


This routine writes system input data sets 
on a direct-access device. If IEFVHG is 
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unable to obtain enough space to complete 
writing a data set, control passes to 
IEFVHR. If the input reaches end-of-file, 
control passes to IEFVHAA. If a /* is 
found following DD DATA, control passes to 
IEFVHA to read the next record. If a // is 
found, control passes to IEFVHC to identify 
the verb. 


e Entry: IEFVHG 
e Exits: To IEFSD536, IEFVGM, IEFVHQ, 





IEFVHAA, IEFVHA, IEFVHC, or IEFVHB 

e Tables/Work Areas: IWA, JCT, SIOT, 
VOLT, TIOT, LWA, SCT, JFCB, UCB, QMPA, 
CWA 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHG 


IEFVHH: Interpreter -- Job and Step 
Enqueue Routine 


This routine places the SCT, DSNT, VOLT, 
and JCT in the job‘s queue entry, and 
determines whether the interpreter is. to 
enqueue jobs. 


e Entry: IEFVHH 
e Exits: To IEFKG, IEFVHQ, IEFSD532, 





ITEFVHHB, IEFVHN 


e Tables/Work Areas: 
QMPA, NEL 


IWA, JCT, SCT, 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHH 


ITEFVHHB: Interpreter -- Housekeeping 
Routine 


This routine initializes for merging a 
cataloged procedure. 


e Entry: IEFVHHB 
e Exits: IEFVHA, IEFVHEB 


Tables/Work Areas: IWA 


e Attributes: Read-only, reenterable 


® Control Section:  IEFVHHB 


IEFVHL: Interpreter -- Null Statement 
Routine 


This routine determines the conditions 
under which the null statement was 
encountered, and passes control to the 
proper routine. 


e Entry: ITEFVHL 


148 Job Management with MFT (Release 21) 


e Exits: To IEFVHCB, IEFHEC, IEFVHE, 


IEFVHA 


e Tables/Work Areas: IWA, JCT 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHL 


IEFVHM: Interpreter -- Command Statement 
Routine 


This routine tests for valid command verbs, 
and, if the verb is valid, issues SVC 34 to 
schedule execution of the command. 


e Entry: IEFVHM 
e Exits: To IEFVHA, IEFVGM 


e Tables/Work Areas: IWA, JCT 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHM 


IEFVHN: Interpreter -- Termination Routine 


This routine closes the input stream and 
procedure library data sets, frees main 
storage used by the interpreter, and kbuilds 
the interpreter exit list. 


e Entry: LEFVHN 
e Exit: Return to caller 


e Tables/Work Areas: IWA, JCT, CSCB, 


QMPA 
e Attributes: Read-only, reenterable 
e Control Section: IEFVHN 


IEFVHO: Interpreter -- 
Interface Routine 


ueue Management 


This routine is a common interface between 
the queue management routines and the 
interpreter. If an I/O error occurs, 
IEFVHR receives control. Queue management 
may be unable to allocate space for a job's 
input data. If, in this case, the operator 
replies CANCEL to the message which is 
issued, IEFVHG receives control. 


ITEFVHO 


e Entry: 
e Exits: Return to caller, IEFSD536, or 
ITEFVHG 


e Tables/Work Areas: 
CSCB 


IWA, JCT, QOMPA, 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHQ 








IEFVH1: Interpreter -- Initialization 
Routine 


This routine initializes the interpreter; 
it obtains main storage for and initializes 
the IWA, local work areas, and DCBs. 


e Entry: IEFVH1 


e Exit: To .[EFVH2 


e Tables/Work Areas: UCB, CSCB, IWA, 
DCB, local work area 


e Attributes: Not reusable 


e Control Section: IbFVH1 


IEFVH2: Interpreter -- Initialization 
Routine 


This routine opens the input stream data 
set and the procedure library data set, and 
Obtains main storage for a buffer for 
procedure library records. 


e Entry: IEFVH2 


e Exit: To IEFVHA 


e Tables/Work Areas: IWA, UCB, TIOT 


e Control Section: IEFVH2 
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e Attributes: Not reusable 
IEFVINA: Interpreter -- In-stream 
Procedure Processor 


This routine processes the in-stream 
procedure. It uses the other in-stream 
procedure routines as subroutines to 
perform additional processing. 


e Entry: IEFVINA 
e Exit: IEFVHA, IEFVHCB 


e Tables/Work Areas: EWA, IWA, JCT, 


PARMLIST, QMPA, WORKAREA 
e Attributes: Reenterable 
e Control Section: IEFVINA 


ITEFVINB: 
Routine 


In-stream Procedure Search 


This routine searches the in-stream 
directory for a procedure. 


e Entry: ITEFVINB 
e Exit: Return to caller 


e Tables/Work Areas: 
OMPA, WORKAREA 


IWA, PARMLIST, 


e Attributes: Reenterable 


e Control Section: IEFVINB 


IEFVINC: In-stream Procedure Directory 


Build Routine 


This routine builds a directory entry, if 
one is needed, for an in-stream procedure. 


e Entry: ITEFV INC 
e Exit: Return to caller 


e Tables/Work Areas: 
OMPA, WORKAREA 


IWA, PARMLIST, 


e Attributes: Reenterable 


ITEFVINC 


Control Section: 


IEFVIND: iIn-stream Procedure Expand 
Interface Routine 


This routine reads a record from the job 
queue and issues a LOAD macro instruction 
specifying the expand routine IEZDCODE to 
expand the record. 


e Entry: IEFVIND 

e Exit: Return to caller 

e Tables/Work Areas: DCBD, IWA, 
PARMLIST, QMPA 

e Attributes: Reenterable 

e Control Section: IEFVIND 


IEFVINE: In-stream Procedure Syntax Check 


Routine 


This routine syntax checks the PROC and END 
statements for invalid or non-existant 
labels and/or null operands with comments. 


e Entry: LEFV INE 
e Exit: Return to caller 


e Tables/Work Areas: . 
and test table 


256 byte translate 


e Attributes: Reenterable 


® Control Section: IEFVINE 


IEFVJA: Interpreter -- Job Statement 


Processor 


This routine initializes a JCT and job ACT 
from the complete logical job statement in 
the internal text buffer. | 


e Entry: ITEFVJA 
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e Exit: To ILEFVHF 


e Tables/Work Areas: 
interpreter key table, 


IWA, 


job work area, 
OMPA 





e Attributes: Read-only, reenterable 


e Control Section: IEFVJA 


ITEFVJIMP: Termination -- JOB Statement 


Condition Code e Processor _ 





This routine tests the condition codes 
specified in the JOB statement to determine 
whether the remaining steps in the job are 
to be run. 


e Entry: IEFVJ 
e Exits: To IEFVK or IEFZA 
e Tables/Work Areas: LCT, JCT, SCT 
e Control Section: IEFVJ 
ITEFVIMSG: Termination -- JOB Statement 


Condition _Code Processor _ Messages _ 


This routine contains the messages issued 
to the programmer by the JOB statement 
condition code processor. 


e Entry: IEFVJIMSG 


e Attributes: Non-executable 


e Control Section: IEFVJMSG 


IEFVKIMP: I/0 Device Allocation -- EXEC 
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Statement Condition Code Processor 


This routine tests the condition codes 
specified in the EXEC statement to 
determine whether the next step of the job 
is to be run. 


e Entry: IEFVK 


e Exits: IEFVS, IEFLB 


e Tables/Work Areas: JCT, sct 
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LCT, 
e Control Section: IEFVK 


ILEFVKMSG: I/0 Device Allocation -- EXEC 
Statement Condition Code Processor Messages 


This routine contains the messages issued 


to the programmer by the EXEC -- statement 
condition ~-- code processor. 
e Entry: IEFVKMJ1 


e Attributes: Non-executable 


e Control Section: IEFVKMSG 
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IEFVMFAK: I/O Device Allocation -- Linkage 
to ITEFVMLS1 


This routine passes control to entry point 
IEFVMCVL of the JFCB housekeeping module 
IEFVMLS1 via the XCTL macro instruction. 


@ Entry: IEFVMCVL 
e Exit: To ILEFVMCVL 


® Control Section: IEFVMCVL 


IEFVMLS1: I/O Device Allocation -- JFCB 


Housekeeping Control Routine and Allocate 
Processing Routines 


The control routine obtains the required 
SIOTs, determines the processing required 
for each, and passes control to the 
appropriate routine. The allocate 
processing routine performs the processing 
required in certain refer-back situations, 
when the data set is cataloged or passed, 
and when unit name is specified. 


LTEFVM, IEFVMCVL, IELFVMOMI, 
VM7055, VM7055AA, VM7060, 
VM7090, VM7130, VM7370, VM7700, 
VM7750, VM7850, VM7900, VM7950 


® Entry: 
VM7000, 


VM/070, 
VM7742, 


To IEFVM2LS, 
IEFVM5SLS, 
IBRFDSOAL 


IEFVM3LS, 
LEFVM6LS, 


e Exits: 
ITEFVM4Ls, 
LEFXCSSS, 





and 


e Tables/Work Areas: LCT, JCT, PDQ, 


SIOT, JFCB, QMPA 


e Control Section: IEFVM1 


IEFVMLS6: I/0 Device Allocation -- JFCB 


Housekeeping Error Message Processing _ 
Routine 


This routine prepares error messages for 
the JFCB housekeeping routines. 


e Entry: IEFVMSGR 

e Exit: Return to caller 

© Tables/Work Areas: JCT, LCT 
e Control Section: IEFVM6 


IEFVMLS7: I/0 Device Allocation -- JFCB 
Housekeeping Error Messages 


This routine contains the messages issued 
by the JFCB housekeeping routines. 
e Entr LTEFVM7 


e Attributes: Non-executable 


e Control Section: IEFVM7 


x, Stoo 


TEFVMMS1: 120 _Device Allocation -- Linkage 
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This routine provides a linkage to the JFCB 
housekeeping routines for the step flush 
function. 


e Entry: IEFVM1 

e Exit: xXCTL to IEFVMLS1 

e Attributes: Read-only, reenterable 

e Control Section: IEFVM1 
LEFVM2LS: I/70 Device Allocation -~ JFCB 
Housekeeping Fetch DCB Processing Routine 
This routine updates the SIOT, SCT, JFCB 
and VOLT with information reguired for the 
allocation of devices for the fetch DCB. 

e Entry: VM7100 

e Exit: To IEFVMLS1 


e Tables/Work Areas: LCT, SCT, SIOT, 
JFCB, VOLT 


e Control Section: IEFVM2 


IEFVM3LS: I/0 Device Allocation -- JFCB 
Housekeeping GDG Single Processing Routine 
This routine obtains the fully qualified 
name of a member of a generation data group 
(GDG), and completes the required 


information in the JFCB, VOLT, and SIOT for 
that member. 


e Entry: VM7150 
e Exit: To IEFVMLS1 


e Tables/Work Areas: LCT, SIOT, GDG Bias 
Count table, JFCB 


e Control Section: IEFVM3 
IEFVM4LS: I/0 Device Allocation -- JFCB 
Housekeeping G GDG _ All _ 1 Processing Routine 
This routine builds an SIOT, JFCB, and 
VOLT, and PDQ entries for each member of 
the GDG. 

e Entry: VM7200 
e Exit: To IEFVMLS1 


e Tables/Work Areas: LCT, SCT, VOLT, 


PDQ, S1OT, JFCB 


e Control Section: IEFVM4 


ITEFVM5LS: I/0 Device Allocation -- JFCB 
Housekeeping Pattern Patterning DSCB Routine 


This routine establishes DCB control 
information within a JFCB. 


e Entry: VM7300 
® Exits To IEFVMLS1 


e Tables/Work Areas: LCT, SCT, SIOT, 
DSCB, JFCB 


e Control Section: IEFVM5 


ITEFVM/6: I/0 Device Allocation -- JFCB 
Housekeeping Unique Volume ID Rout Unigue Volume ID Routine _ 


This routine creates unique volume serials 
for unlabeled tape data sets, when the 
disposition is "PASS". 

e Entry: VM/600 
e Exit: Return to caller 
® Tables/Work Areas: SIOT, JFCB, JFCBX 


e Control Section: ILIEFVM76 


ITEFVRRC:  Reinterpretation Control Routine 


This routine passes control among the 
routines that modify the queue entry of a 
restart step so that they appear as they 
were prior to the initiation of the step. 
e@ Entry: IEFVRRC, ITEFVRRCA, IEFVRRCB 
e Exit: Return to caller 
e Attributes: Read-only reenterabie 
@ Tables/Work Areas: NEL, JCT, SCT, 
SIOT, JFCB, JFCBX, VOLT, SMB, DSENQ, 
SCD, DSB, QMPA 


e Control Section: IEFVRRC 


IEFVRR1: Dequeue Interface Routine 


This routine interfaces with queue 
Management to cause a specific job to be 
dequeued and the JCT for that job to be 
read into main storage. 

e Entry: IEFVRR1 

e Exit: Return to caller 

e Tables/Work Areas: QMPA, JCT 


e Attributes: Read-only, reenterable 


e Control Section: IEFVRR1 
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LEFVRR2: Table Merge Routine 

This routine merges the reinterpreted queue 
entry tables of a restart step with the 
Original queue tables for that step. 


e Entry: IEFVRR2, IEFVR2AE 
e Exit: Return to caller 


e Tables/Work Areas: QMPA, JCT, ACT, 
SMB, SCT, SIOT, JFCB, DSENQ, VOLT, 


JFCBX, NEL 








e Attributes: Reenterable 


e Control Section: IEFVRR2 


IEFVRR3: Reinterpretation Delete/Enqueue 


Routine 


This routine deletes the reinterpreted 
input and output queue entries of a restart 
step, constructs the internal JCL necessary 
for processing a checkpoint restart, and 
reenqueues the job's queue entry. 


e Entry: IEFVRR3, IEFVR3AE 
e Exit: Return to caller 


e Tables/Work Areas: 
SIOT, JFCB 


QOMPA, JCT, SCT, 


e Attributes: Reenterable 


e Control Section: IEFVRR3 


IEFVSDRA: Restart Activation Routine 


This routine issues a START Restart Reader 
command for one or more jobnames. This 
routine is entered from IEFSD168 during a 
problem program restart or IEFSD305 during 
a warm start. 


e Entry: IEFVSDRA. 
e Exit: Return to caller 


e Tables/Work Areas: CSCB, CVT, TCB 


e Attributes: Reenterable 


e Control Section: IEFVSDRA 


IEFVSDRD: Restart Determination Routine 


AR IP ASR ARNE NS ACERT EOS 


This routine initiates automatic restarts. 


e Entry: IEFVSDRD 
e Exit: To IEFSD305 


e Tables/Work Areas: JCT, SCT, QMPA, 


CVT, TIOT, LCT 
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e Attributes: Reenterable 


e Control Section: IEFVSDRD 


ITEFVSD1i2: Interpreter -- CPO Allocation 
Subroutine 


This routine sets up a JFCB and allocates 
space on a direct-access device for a 
system input data set. 


® Entry: LTEFSD012 
e Exit: Return to caller 


e Attributes: Reenterable 
e Tables/Work Areas: IWA, QOMPA, LWA, 
SIOT, TIOT, UCB, JFCB, JCT, CSCB 


e Control Section: IEFSD012 


e External References: IEFVH) 


IEFVSD1i3: Interpreter -- SCD Construction 
Routine 


This routine constructs an SCD entry for 
each system output class defined for a job, 
and assigns space for all DSBs that will be 
required. 


e Entry: IEFSDO090 
e Exit: Return to caller 


e@ Tables/Work Areas: IWA, QMPA, DD work 
area, SCD, SCT, SIOT, JCT, JFCB 


e Control Section: IEFSD090 


IEFVSMBR: SMB Reader Routine 

This routine reads the SMBs associated with 

a restarting job and converts the JCL 

statements to their original format. 
e Entry: IGCO0O0O5B 

e Exits: If called during restart reader 
processing, return to caller; if called 
during restart, XCTL to the first load 
of restart housekeeping. 


e Tables/Work Areas: 
SMB, RRCWKAR, SCT 


QMPA, DCB, JCT, 


e Attributes: Reenterable 


e Control Section: IEFVSMBR 


IEFWA000: I/O Device Allocation -- Demand 
Allocation Routine 


This routine establishes data set device 
requirements, and allocates in response to 
specific unit requests. 





e Entry: JIEFWA000, IEFUCBL 
e Exits: To IEFWD000, IEFX3000, LEFX5000 


UCB Address List, 
SIOT, VOLT, AWT 


e Tables/Work Areas: 
DMT, UCB, LCT, SCT, 
TEFWA002 


e Control Sections: IEFWAT7, 


IEFWCFAK: I/O Device Allocation -- Linkage 
Module 


This routine passes control to the TIOT 
construction routine. 
IEFWC 002 


e Entry: IEFWCOOO, 


e Exit: To IEFWCIMP 


e Control Section: 
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ITEFWC000, IEFWCO0O02 


IEFWCIMP: I/0 Device Allocation -- TIOT 
Construction Routine 


This routine calculates the main storage 
required for the TIOT, builds the TIOT, and 
processes requests for direct-access space. 


e Entry: IEFWCO00O0 
e Exits: To IEFXJIMP, ILEFWDO0O0O 
e Tables/Work Areas: JCT, SCT, LCT, 
SIOT, VOLT, AWT, TIOT 
e Control Section: IEFWC000 
IEFWDFAK: I/O Device Allocation -- Linkage 


Module 


This routine passes control to the external 
action routine. 


e Entry: IEFWDOO0O 
e Exit: To IEFWDO000 


e Control Section: IEFWD0O00 
ITEFWD000: I/0 Device Allocation -- 
External Action Routine 


This routine ensures that the correct 
volumes are mounted on the appropriate 
units for new data sets and that SCRATCH 
volumes are mounted on the appropriate 
devices. It also sets up interfaces for 
the mounting of volumes needed for old data 
sets. 


°e Entry: IEFWD000, IEFWDMSG 

e Exits: To IEFXTO00, IEFW41SD, IEFXK000 

e Tables/Work Areas: SCT, LCT, TIOT, 
UCB, JFCB, ATCA, MVA, MVAX 


® Control Section: ITEFWD0O00, IEFWDMSG, 
IEFWDO002 
IEFWD001: I/0 Device Allocation -- 


External Action Messages 


This routine contains a directory and the 
messages used in the external action 
routine. 


e Entry: TEFWDOOL 


e Attributes: Non-executable 


e Control Section: IEFWDOO1 


IEFWEXTA: I/70 Device Allocation -- 
Extended External Action Routine 


This routine ensures that the correct 
volumes are mounted on the appropriate 
units for old data sets. 


e Entry: TEFWEXTA 
e Exits: to ITEFW41SD, IEFXK000 


® Tables/Work Areas: 
SCT, UCB 


CSCB, LCT, MVI, 


e Control Section: IEFWEXTA 


IEFWSMSG: Termination-Message Routine for 
Warmstart 


This routine contains messages to be used 
by module IEFWSYP3 during warmstart. 
® Entry: LEFWSMSG 


e Attributes: Non-executable 


e Control Section: IEFWSMSG 
IEFWSTRT;: I/O Device Allocation -- Message 
Module 


This routine contains the message issued to 
the operator when a job is Started and the 
messages issued to the operator when a job 
is terminated due to ABEND, condition 
codes, or JCL errors. 


e Entry: IEFWSTRT 


e Attributes: Non-executable 


e Control Section: IEFWSTRT 
IEFWSWIN: I/0 Device Allocation -- Linkage 
Module 


This routine passes control to the decision 
allocation routine. 


e Entry: LEFWSW IT 
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e Exit: To IEFX5000 


e Control Section: IEFWSWIT 


IEFWSYP3: Termination-SIOT Reader Routine 
for Warmstart 


This routine either matches TIOT entries 
with SIOTs or, in the case of dynamically 
allocated data sets, builds TIOT entries 
for use by the termination routines. 


e Entry: IEFWSYP3 
e Exit: Return to caller 


e Tables/Work Areas: QMPA, JCT, LCT, 


SIOT, UCB, TIOT, SIOTTTR, TIOTEXT 


e Control Section: IEFWSYP3 


IEFWIERM: Termination -- Message Module 


This routine contains the message issued to 
the operator when a job is terminated 
normally, or when it is terminated because 
of a JCL error found in the interpreter or 
initiator. 


e Entry: ITEFWTERM 


e Attributes: Non-executable 


e Control Sections ILIEFWTERM 


IEFWIPO00: Write-to-programmer 
Initialization Routine 


This routine initializes storage and 
registers to process write-to-programmer 
messages if the WTP call is valid. 


e Entry: IGC0203E from IEECVWTO 
e Exits: Normal to IEFWTP01, to calling 


program if only a WTP is requested and 
the WIP limit has been exceeded, to 
IEECVWTO if WTP request cannot be 
processed or a WTO message was also 
requested. 


e® Tables/Work Areas: 


WIPCB, JSCB, UCM, 
CVT, WPL, IEFOMNGR, | 


ITEFQMRES 


e Attributes: Reenterable 


° Control Section: IGC0203E 


ITEFWTPO1: Write-to-programmer Message 
Processing Routine 


This routine processes the WIP messages and 
writes them on the job queue using the 
transient queue manager (SVC-90). 

e Entry: IGC0303E from IEFWTP00 or 
IEFWTP 02 
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e Exits: Normal to IEECVWTO or to 
calling program if only a WTP is 
requested; to IEFWTP02 for processing | 
I/O errors which occur while writing a Me. 
WIP message or for job queue problems. 


e Tables/Work Areas: WTPCB, JSCB, UCM, 
CVT, WPL, IEFOMNGR, IEFOMRES 


e Attributes: Reenterable 


e Control Section: IGC0303E 


IEFWTP02: Write-to-programmer Error 
Processing Routine 


This routine handles WTP processing using 
the reserved WTP SMBs for messages when 
there are I/O errors in the job queue or 
when WTP is unable to get a record assigned 
for a WIP message using the transient queue 
manager. 


e Entry: IGCO403E from IEFWTPO1 
e Exits: Return to IEECVWTO, to calling 


program if only a WTP was requested, or 
IEFWTP01 if a system WTP message is to 
be processed following a NO RECORD 
message. 


WTPCB, JSCB, UCM, 
LTEFQMRES ot 


® Tables/Work Areas: 
CVT, WPL, IEFQUNGR, 


e Attributes: Reenterable 


e Control Section: IGGO403E 


IEFXAMSG: I/0 Device Allocation -- Message 
Module 


This routine contains the messages issued 
by the allocation control routine. 


® Entry: LEFXAMSG 


e Attributes: Non-executable 


e® Control Section: JIEFXAMSG 
IEFXCSSS: I/O Device Allocation -- 
Allocation Control Routine 


This routine calculates table space 
requirements and obtains the main storage 
for the tables used or built during 


allocation. 
e Entry: LEFXA 
e Exits: To ITEFXJ, IEFWA, IEFWC 


e Tables/Work Areas: 
SIOT, VOLT, AWT 


gcT, SCT, LCT, UCB, 


e Control Section: 


IEFXA S 





IEFXHO00 : £70 _Device Allocation -- 
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This routine strikes from AWT entries, the 
bits corresponding to devices that would 
violate separation or affinity requests. 


e Entry: IEFXHOOO 
e Exit: Return to caller 
e Tables/Work Areas: LCT, AWT, AVT, UCB 


e Control Section: IKFXH0O00 
IEFXJFAK: 1/70 Device Allocation -- Linkage 
Module 


This routine passes control to the 
allocation recovery routine. 


e Entry: IEFXJ000 

e Exit: To IEFXJIMP 

e Control Section: I:FXJ000 
TEFXJIMP: I/70 Device Allocation -~ 
Allocation Recovery Routine 
This routine informs the operator of the 
allocation recovery options available, and 
passes control to the proper routine to 
comply with his request. 

e Entry: IEFXJ000, IEFV15XL, IEFXJX5A 
To IEFXCSSS, IEFSD095, IEFW41SD 


e Exits: 


e Tables/Work Areas: LCT, AWT, JCT, CVT, 
UCB, SCT, SIOT 





e Control Section: IEFXJ000 


IEFXJIMSG: I/0 Device Allocation -- 
Allocation Recovery Messages 


This routine contains the messages used by 
the allocation recovery routine. 


e Entry: MSRCV, MSSYS, MSOFF 
e Attributes: Non-executable 
e Control Section: I£FXJMSG 


IEFXKIMP: I/0 Device Allocation -- 
Non- -Recovery _ Error _ Routine 


This routine cancels the step when a lack 
of available devices has been discovered 
after the TIOT is constructed. 

e Entry: IEFXKO000 


e Exit: To IEFW41SD 


e Tables/Work Areas: LCT, SCT, UCB, TIOT 


e Control Section: IEFXKOOO 


IEFXKMSG: I/O Device Allocation -- 
Non-Recovery Error Routine Messages 


This routine contains the messages used by 
the non-recovery error routine. 


e Entry: LEFXKMSG 
® Attributes: Non-executable 


e Control Section: IEFXKMSG 


IEFXQMO0: Transient Queue Manager 


Initialization and Read/Write Routine 


This routine initializes tables and read or 
writes job queue records. 
e Entry: ITGCO0090 


e Exits: xXCrL to IGC01090 or return to 
caller 


® Tables/Work Areas: QO/M resident data 
area, QOMPA, CVT, ECB/1I0OB 


e Attributes: Reenterable 


e Control Section: IGC00090 


eaETG Routine 


This routine assigns logical tracks as 
required. 


e Entry: IGC01090 
e® Exits: xXCIL to IGC02090 or return to 
caller 


e Tables/Work Areas: QM resident data 
area, QMPA, CVT, ICB/IOB 


e Attributes: Reenterable 


e Control Section: IGC01090 


IEFXQM02: Transient Queue Manager Record 
Assignment Routine 


This routine assigns records to a queue 
entry. 


e Entry: IGCO02090 
e Exits: Return to caller 


e Tables/Work Areas: QM resident data 
area, QMPA, CVT, ECB/IOB 


e Attributes: Reenterable 
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e Control Section: I1G6C02090 | 
TEFXTOOD: I70 Device Allocation ~-- Space 


This routine obtains space on direct-access 
devices for requesting data sets. 


e Entry: IEFXTOOO 
e Exits: To IEFW41SD, IEFXK000, IEFWDOOO 


e Tables/Work Areas: 
ICT, SIOT, JFCB, PDQ 


LCT, TLOT, UCB, 
XTTP00, IEFXTO0O 


e Control Section: 


TEFXTO02: 1/0 Device Allocation ~~ VARY 
Command Interface TIOT Compression Routine 





This routine reduces the TIOIT to its final 
Size and provides an interface with the 
VARY command. 


e Entry: IEFXT002, XTTRDJ, XTTEB3, 
XTTEA1, XTTEAO 


e Exits: to IEFXKIMP, IEFXT003, IEFWEXTA 


LCT, TIOT, UCB, 


e Control Section: IEFXTO002 


IEFXTO03: I/O Device Allocation -- DADSM 


This routine determines what action should 
be taken when the request for space on a 
particular volume fails. 


e Entry: IEFXTO03, XUUHO06, XUUBOO 


e Exits: To IEFXTOOD, IEFXT002 


e Tables/Work Areas: 
JcT, SIOT, JFCB 


LCT, TIOT, UCB, 


e Control Section: IEFXT003 
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Automatic Volume Recognition Messages 


This routine contains the messages used by 
the automatic volume recognition (AVR) 
routine. 

e Entry: IEFXVMSG 
e Attributes: Non-executable 


e Control Section: IEFXVMSG 
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IEFXVNSL: I/O Device Allocation -- 


Automatic Volume Recognition -- - 
Non-Standard Label Routine 


This routine processes non-standard labels 
for the AVR routine. 


e Entry: TEFXVNSL 


e Exit: Return to caller 


e Control Section: IEFXVNSL 


IEFXVO0O1: I/O Device Allocation -- 


Automatic Volume Recognition Routine 


This routine finds and allocates volumes 
pre-mounted by the operator. 


e Entry: LEFXV001 


e Exits: IEFWCO0O0, IEFX5000, IEFXJ000 
e Tables/Work Areas: JCT, SCT, AWT, AVT, 
VOLT, SIOT, LCT, UCB 


e Control Section: IEFXVOO1L 


IEFXV002: I/O Device Allocation -- 


Automatic Volume Recognition, Label 
Processing 


This routine reads the label of a newly 
mounted volume, extracts the serial number, 
and places it into the UCB for the 
corresponding device. 


e Entry: LEFXV002 


e Exits: To IEFXVNSL via CALL, return to 


caller. 
* Tables/Work Areas: LUT, UCB, CVT, DEB, 
IOB 


e Attributes: Reusable 


e Control Section: IEFXV002 


IEFXVO003: 
Unmounted Tape Allocation Routine 


This routine determines the best allocation 
solution for unmounted 3400 9-trk and 2400 
9-trk tape requests based on the device 
configuration. 


e Entry: IEFXV003 


e Exit: To IEFXV002, return to caller 


e Tables/Work Areas: 


e Attributes: 


ACB, AWT, UCB, LCT 
Reusable 2 


e Control Section: IEFXV003 oe 





I/O Device Allocation -- Device 
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Strikeout Routine 


this routine modifies the primary and 
secondary bit patterns in AWT entries to 
complete the allocation to a data set. 


e Entry: IEFX3000, X33B42 
e Exit: Return to caller 


e Tables/Work Areas: AWT, AVT, UCB, LCT 


e Control Section: I&FX3000 
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This routine selects devices for data sets 
with multiple unit possibilities. 


e Entry: IEFX5000, XIIB32, X55C86, 
X55D3G 
e Exits: To IEFWC000, IEFXJ000 


e Tables/Work Areas: LCT, AWT, AVT, UCB 


e Control Section: IEFX5000 
IEFYNIMP: Termination -- Step Termination 


Control Routine 


This routine passes control among the 
modules of the step termination routine 
and, when required, passes control to the 
job termination routine. 


e Entry: IEFYN 
e Exits: To IEFW22SD, IEFYPJB3, IEF- 
VJIMP, IEFZAJB3, IEFRPREP 
e Tables/Work Areas: JCT, SCT, LCT 
e Control Section: IEFYN 
TEFYNMSG: Termination -~ Step Termination 
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This routine contains the messages required 
for the step termination control routine. 


e Entry: IEFYNMSG, STRMSGO1 


e Attributes: Non-executable 


e Control Section: IEFYNMSG 
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Data Set Driver Routine 


This routine obtains SIOTs and to pass 
control to the disposition and unallocation 
routine. 


e Entry: IEFYP 


e@ Fxits: To IEFZG, LEFYNIMP 
e Tables/Work Areas: 


QMPA, SIOT, ICB 


LCT, TIOT, UCB, 


e Control Section: IEFYP 


IEFYPMSG: Termination -- Step Termination 
Messages 


This routine contains the messages required 
by the step termination routine. 
YPPMSG1, YPPMSG2 


e Entry: ILEFYPMSG, 


e Attributes: Non-executable 


e Control Section: IEFYPMSG 


IEFYSVMS: Termination -- Message Blocking 


Routine 


This routine blocks system messages into 
SMBs, and places SMBs into the message 
class queue entry. 


e Entry: IEFYS 

e Exit: Return to caller 

e Tables/Work Areas: LCT, SCT, SMB 

e Attributes: Reenterable 

e Control Section: IEFYS 
LEFYTWMS : Termination -- DSB Processing 
Routine 


This routine places data set blocks in the 
Space reserved for them in the output queve 
entries. If a job used DSO, the data set 
blocks are marked inactive. 


e Entry: LEFYT 
e Tables/wWwork Areas: JCT, SCT, TIOT, 
SIOT, QMPA, DSCB, LCT, CVT, JFCB, 
DSOCB, PIB 
e Attributes: Reenterable 
e Control Section: IEFYT 
IEFZAJB3: Termination -- Job Termination 


Control Routine 


This routine provides entry to the job 
termination routine, obtains PDO blocks, 
and passes control to the disposition and 
unallocation routine. 


e Entry: LTEFZA 
e Exits: To IEFZGJ, IEFW31iSD 
e Tables/Work Areas: LCT, JCT, PDO, UCB, 


QMPA 
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e Control Section: IEFZA 


IEFZGJB1: Termination -- Disposition and 
Deallocation Routine 


This routine directs the disposition and 
deallocation of those data sets that remain 
to be processed at job termination: passed 
data sets that were not received, and 
retained data sets that were not referred 
to. 

ZPOOM 


e Entry: IEFZGJ, 


® Exit: Return to caller 


e Tables/Work Areas: Jct, 
LCT, OMPA, UCB 


PDQ, JFCB, 





e Control Section: IEFZsJ 


IEFZGMSG: Termination ~- Disposition and 
Deallocation Messages 


This routine contains the messages required 
for the disposition and deallocation 
routine (IEFZGJB1). 


e Entry: IEFZGMSG 


e Attributes: Non-executable 


e Control Section: IEFZGMSG 


F4Goits sermination ~~ V1 


Deallocation Routine 


This routine directs the disposition of 
data sets as specified in the DISP field of 
the DD statement, and makes the associated 
units available for allocation to other 
data sets. 


IEFZG, ZPOQMGR1 


e® Entry: 
e Exit: Return to caller 


e Tables/Work Areas: LCT, PDQ, SIOT, 
TLIOT, UCB, JFCB, ~ QMPA 





e Control Section: IEFZG 
IEFZGST2: Termination -- Unallocation 
Routine | 


This routine makes available to other data 
sets the units used by the terminating job 
step. 


ZOOAI1, 


e Entry: IEFZG2, ZGOKO09, ZOOE10, 
ZPOC10, ZPOQMGR2 
e Exit: Return to caller 


e Tables/Work Areas: LCT, PDQ, SIOT, 
TIOT, UCB, JFCB, OMPA 
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e Control Section: IEFZG2 


IEFZHMSG: Termination -- VARY Command 


Interface and Disposition and De Disposition and Deallocation 


Message Routine 


This routine prepares messages to the 
programmer and to the operator for the 


disposition and allocation routines. It 
also provides an interface with the VARY 


command. 
e@ Entry: IEFZH, ZGOE60, ZKOD1, ZKOEI1, 
XPS631 
e Exit: Return to caller 


e Tables/Work Areas: LCT, QOMPA, SMB 


e Control Section: IEFZH 


IEFO78SD: System Output Writer -- Linkage 


Module 


This routine transfers control to module 


IEFSDO78. 
e Entr ITEFS D078 
e Exit: To IEFSDO78 


e Attributes: Reenterable 


IEFO79SD: System Output Writer -- Linkage 


Module 


This routine transfers control to IEFSDO79. 


e Entr LTEFSDO79 


e Exit: To IEFSDO79 


e Attributes: Reenterable 


IEFO82SD: System Output Writer -- Linkage 


Module 


This routine passes control to the system 


output writer main processing routine. 
e Entr ITEFSD082 
e Exit: To IEFSD082 


e Control Section: IEFSD082 


IEFO83SD: System Output Writer -- L 
Module 


inkage 


This routine passes control to the system 


output writer command processing routine. 


e Entry: IEFSD083 
e Exit: IEFSD083 


e Control Section: IEFSDO083 





TEF300SD: System Restart -- Linkage Module 


fhis routine provides a linkage to the 
system restart initialization routine. 


e Entry: IEFSD300 


e Exits: To IEFSD300, IEFSD055 


e Attributes: Reenterable 
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This routine provides a linkage to the 
system restart scratch data sets routine. 


e Entry: IEFSD304 


e Exits: To IEFSD304, IEFSD055 


e Attributes: Reenterable 


e Control Section: IEFSD304 
ITEF41DUM: Allocation -- Return to 
initiator or System Task Control 


This routine returns control to the 
Initiator or to System Task Control after 
device allocation has completed. If 
allocation was called by the Initiator, the 
routine returns control to step initiation 
routine IEFSD512 at entry point ITEFALRET 
Via an XCTL macro instruction. If 
allocation was called by System Task 
Control, the routine returns control to the 
caller. 


e Entry: IEFSD4iR 

e Exits: IEFALRET or return to caller 

e Tables/Work Areas: CSCB, LCT 

e Attributes: Reenterable 

e Control Section: IEFSD41R 
TEF4YIFAK: I/70 Device Allocation ~~ Linkage 
Module 


This routine provides a linkage to the 
allocation exit routine during step flush. 


e Entry: IEFW4iSD, IEFWIFAK, I[EFW2FAK 


e Exit: To IEFW41SD 


e Attributes: Read-only, reenterable 


e Control Section: IEFW41SD_ 
TEFS589SP3 System Task Control -- Linkage 
to IEFSD584 


This routine links to IEFSD584 so that upon 
return, the initiator will be in supervisor 
State. 


e Entry: TEF589SP from IEFSD599 
® Fxit: Link to IEFSD584, XCTL to 





ITEFSD599 


e Control Section: IEF589SP 


LEZDCODE: Interpreter -- In-stream 
Procedure Expand Routine 


This routine expands a given statement to 
its original form by inserting a given 
Character. 


e Entry: IEZDCODE 


© Exit: Return to caller 


e Tables/wWwork Areas: IEZPARM 


e Attributes: Reenterable 


e Control Section: ILEZDCODE 


TEZNCODE: Interpreter -- In-stream 
Procedure Compress Routine 


This routine compresses a given statement 
by removing a given character. The new 
statement that is formed contains the 
number of the removed character. 


e® Entry: LTEZNCODE 


2® Exit: Return to caller 


e Tables/Work Areas: IEZPARM 


e Attributes: Reenterable 


e Control Section: IEZNCODE 
IGCOO0O08C: SVC 83 -- SMF Buffer Manager and 
Writer Routine 


The purpose of this routine is to move SMF 
records into the SMF buffer, and to cause 
the records to be written when the buffer 
is full. 


e® Entry: I1GC00083 

e Exit: IEESMFOP, return to caller 

® Tables/Work Areas: CVT, SMCA 

e Attributes: Reentrant 

e Control Sections: IGC00083 
IGCO0103D: SVC 34 ~~ Master Command EXCP 
Routine 


This routine processes the MOUNT Command. 


e Entry: IGC0103D 
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e Attributes: Reenterable, transient 


e Control Section: IGC0103D. 


IGFO8501: SVC 34 -- Machine Status Control 
ROutine - Model 85 (1) 


This routine is available only for the 


model 85. It processes the status 
parameter of the MODE command. 

e Entry: IGF08501 

e Exit: IGF08502 


e Tables/Work Areas: CVT, XSA, MSB 
e Attributes: Reenterable, read-only, 
self-relocating 


e Control Section: IGF08501 


Routine ~— Model 85 (2) 


This routine is available only for the 
model 85. it processes all parameters of 
the MODE command but the status parameter. 


e Entry: IGF08502 
® Exit: Return to issuer of SVC 34 


e Tables/Work Areas: CVT, XSA 

e Attributes: Reenterable, read-only, 
self-relocating 

e Control Sections: IGF08502 

IGF13501: SVC 34 -- Machine Status Control 

Routine - Model 135 


This routine processes the MODE command for 
the Model 135. 


e Entry: IGF1i3501 
e Exit: Return to the issuer of SVC 34 


e Tables/Work Areas: 


e Attributes: 
transient 


Reenterable, read-only, 


e Control Section: IGF13501 
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Processor 


This routine is used only if the Alternate 
Path Retry option is supported. It 
processes an operator's request for varying 
a PATH to a device and causing that path to 
be either logically brought online or 
logically removed from the system. 
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e Entry: IGF2403D from IEE3202D 


e Exit: To IEEOQ503D, IEE2103D 


e Attributes: Reenterable 
e Tables/Work Areas: Test Channel Table, 
SVRB Extend Save Area 


® Control Sections: IGF2403D 


IGF2503D;s SVC 34 —- SWAP Command Processor 
This routine is used only if Dynamic Device 
Reconfiguration is in the system. It 
processes the operator's command to SWAP 
volumes for Dynamic Device Reconfiguration. 
The routine checks the command for proper 
format, sets a switch if the status of DDR 
is to be changed, validates CUAS, and fills 
in certain fields of the I/O RMS 
Communications Area. 


e Entry: IGF2503D from IEEO403D or from 
IGFO4O8E (DDR Tape Reposition) 


e Exit: To ITEEO503D, IEEZ103D, IGFO4O8E 
(DDR Tape reposition) 
e Attributes: Reenterable 


e Tables/Work Areas: I/O RMS 
Communications Area, SVRB Extended Save 


Area 
® Control Sections: IGF2503D 
IGF2603D: Svc 34 -- MODE Command Router 
Routine 


This routine accepts the MODE command and 
passes control to the appropriate machine 
Status control routine depending on the 
machine model. 


e Entry: IGF2603D 
e Exit: XCTL to IGF05801 (for Model 85), 





to IGF29601 (for Model 155), or to 


IGF55301 (for Model 165) 
e Tables/Work Areas: MSB, XSA 


e Attributes: Reenterable, read-only, 
self-relocating, transient 


e Control Section: IGF260 3D 

IGF29601: SVC 34 -- Machine Status Control 
Routine - Model 155 

This routine processes the MODE command for 
the Model 155. 


e Entry: IGF29601 





e Exit: Return to issuer of SVC 34 
e Tables/Work Areas: CVT, MSB, XSA 


e Attributes: Serially reusable, 
read-only, self-relocating 


e Control Section: IGF2960i1 
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IGF29701: SVC 34 -- Machine Status Control 
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Routine - Model 145 
This routine processes the MODE command for 
the Model 145. 

e Entry: IGF29701 

e Exit: Return to issuer of SVC 34 

e tables /Work Areas: CVT, MSB, XSA 


e Attributes: Reenterable, read-only, 
transient 


e Control Section: IGF29701 


IGF55301: SVC 34 -- Machine Status Control 





SE OT NN ET SY A A me 


This routine processes the MODE command for 
the Model 165. 


e Entry: IGF55301 


e Exit: Return to issuer of SVC 34 


e Tables/work Areas: CVT, MSB, XSA 


e Attributes: Reenterable, read-only, 
transient 


e Control Section: IG¥55301 


IKJNULL: SVC 34 -- Command Rejector 


Routine 
This routine is used by MFT and non-TSO MVT 
Systems to reject the DISPLAY USER command, 
because this command is not relevant ina 
non-TSO environment. 

e Entry: IKJNULL, from ITEE3503D 

e Exit: ITEE2103D 

© Tables/Work Areas: XSA 


e Attributes: Reentrant, 
self-relocating, read-only, transient 


e Control Section: IKJNULL 


Appendix B: MFT Modules 161 


APPENDIX C: FLOWCHARTS 


This appendix includes the MFT job management flowcharts that are different from MVT.. 
For the flowcharts on allocation, termination, and system restart, see IBM System/360 
Operating System: MVT Job Management, Program Logic Manual, GY28-6660. 
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Chart 1B. Small Partition Routine (Part 
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Chart 1D. Small Partition Routine 
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Chart 3A. Queue Alter Express Cancel (Part i of 2) 
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Chart 3B. Queue Alter/Express Cancel (Part 2 of 2) 
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Chart 4. Queue Manager Table Breakup Routine 
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Chart 5. 


Master Scheduler Resident 


JEECIR50 B2 








Note - The Resident 
Command Processor 
Never Terminates 


Wait for 
Command 


C3 
IEESD 562 


Job Queue 


Search Routines 












y 
Job Queue 


Commands to 


D3 


IEEDFINI 


Define Routines 









Command 


Command Processor 





Appendix C: 


Flowcharts 


171 


Chart 6A. SVC 34 Command Processing (Part 1 of 4) 
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Chart 6B. SVC 34 Command Processing (Part 2 of 4) 
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Chart 6C. SVC 34 Command Processing (Part 3 of 4) 
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Return 


Chart 6D. SVC 34 Command Processing (Part 4 of 4) 
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Chart 7. IEFSD518 -- Partition Recovery Routine 
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Chart 9A. Job Selection Routine (Part 1 of 5) 
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Chart 9B. Job Selection Routine (Part 2 of 5) 
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Chart 9C. Job-Selection Routine (Part 3 of 5) 
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Chart 9E. Job Selection Routine (Part 5 of 5) 
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Chart 10A. Reader/Interpreter (Part 1 of 3) 
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APPENDIX D: DICTIONARY OF ABBREVIATIONS 


The following acronyms are used in the text 
of this manual: 


Acronym 


ACT 
APL 
APR 
ARSA 
ASB 
BBX 
BRDR 
CSCB 
cvr 
DCB 
DCM 
DDR 
DEB 
DSB 
DSDR 
DSENQ 
DSO 
DSOCB 


ECB 
GDG 
IOB 
IPL 
IWA 
JCL 
JCLS 
JCT 
JFCB 
JFCBX 
JMR 
JSEL 
JSOL 
JSXL 
LCT 
LOT 
LPL 
LTH 


account control table 

allocate parameter list 
alternate path retry 

allocate register save area 
automatic SYSIN batching 
boundary box 

background reader 

command schedulinc control block 
communications vector table 
data control block 

display control module 

dynamic device reconfiguration 
data extent block 

data set block 


data set descriptor record 


data set enqueue table 
direct system output 

direct system output control 
block 

event control block 
generation data group 
input/output block 

initial program loading 
interpreter work area 

job control language 

job control language set 

job control table 

job file control block 

job file control block extension 
job management record 

job scheduling entrance list 
job scheduling option list 
job scheduling exit list 
linkage control table 
life-of-task block 

link parameter list 

logical track header 


Acronym 


LSW 
M/S 
MCS 
MFT 


MRCT 
NEL 
NIP 
OPT 
PDY 
PIB 
PSW 
OCR 
OMPA 
RB 
RJE 
SACB 
SCD 
SCT 
SDT 
SLOT 
SMB 
SMCA 
SMF 
SPIL 
SQA 
STC 
SVC 
SYSIN 
SYSOUT 
TBR 
TCB 
TCT 
TCTLOT 


TLIOT 
TOCR 
TOL 
UPL 
UCM 
UCME 
WIP 
WIPCB 


ASA 


Appendix Ds 


Meaning 


local word area 

master scheduler 

multiple console support 
multiprogramming with a fixed 
number of tasks 

message routing control table 
interpreter entrance list 
nucleus initialization program 
Option buffer 

passed data set queue 
partition information block 
program status word 

queue control record 

queue manager parameter area 
request block 

remote job entry 

screen area control block 
System output class directory 
step control table 

START descriptor table 

step input/output table 
system message block 

system management control area 
system management facility 
small partition information list 
system queue area 

system task control 
Supervisor call 

system input 

system output 

table breakup routine 

task control block 

timing control table 

timing control task input/output 
table 

task input/output table 

table queue control record 
timer queue element 

user's parameter list 

unit control module 

unit control module entry 
write-to- programmer 
write-to-programmer control 
block 

extended save area 
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Indexes to program logic manuals are 
consolidated in the publication IBM 
System/360 Operating System: Program Logic 
Manual Master Index, GY28-6717. For 
additional information about any subject 
listed below, refer to other publications 
listed for the same subject in the Master 
Index. 


Account control table (ACT) 30 
Accounting routine 33 

ACT (see account control table) 
Allocate parameter list (APL) 29,33 
Allocate register save area (ARSA) 
Alternate path retry (APR) 37 


29,33 


] Alternate step deletion routine 33 


APL (see allocate parameter list) 

APR (see alternate path retry) 

ARSA (see allocate register save area) 
Automatic commands 17 

Automatic SYSIN batching (ASB) queue 52 


Background reader (BRDR) queue 52 
BBX (see boundary box) 
Boundary box (BBX) 46,51 


CANCEL command 
queue alter routine processing of 39-41 
Svc 34 processing of 38 
Checkpoint/Restart 
internal queue 23 
partition recovery routine 33 
Command processing 
master scheduler resident command 
‘processor 39 
DEFINE command processor 42-45 
queue alter routine 39-41 
SVC 34 37-39 
system task control 46-51 
Command scheduling control block (CSCB) 
chain 39 
creation of 
queue manager 23 
Svc 34 38,39 
format and description of 65-68 
CONTROL command routines 124-127 
CSCB (see command scheduling control block) 


Data control block (DCB) 

construction of 53 
Data extent block (DEB) 

construction of 53 
Data set block handler routine 35 
Data set descriptor record (DSDR) 30 
Data set enqueue table (DSENQ) 28 
format and description of 69 
Data set integrity 28 


| Data set writer linkage routine 35 





INDEX 


DCB (see data control block) 
DDR (see dynamic device reconfiguration) 
DEB (see data extent block) 
DEFINE command processing 
by the master scheduler resident command 
processor 42-45 
by SVC 34 38 
flowchart 44 
Defining control program areas 17 
Definition routines (see DEFINE command 
processing ) 
DEQ macro instruction 
DEFINE command processor use of 46 
queue management use 52,55,58 
small partition module use 26 
Dequeue by jobname interface routine 34 
Dequeue routine 58 
Direct system output control block 
(DSOCB) 28 
Direct system output (DSO) processing 
job initiation routine use of 28 
step deletion routine use of 32 
step initiation routine use of 29 
DISPLAY command processing 
A 39,40 
C,K 39 
CONSOLES 40 
jobname 39 


N 39,41 
PFK 39,40 
QO 39,41 
R 37 

TT: 37 

U 40 


DSB (see data set block) 

DSDR (see data set descriptor record) 
DSENQ (see data set enqueue table) 

DSNAME parameter 28 

DSO (see direct system output processing) 

DSOCB (see direct system output control 
block) 

Dynamic device reconfiguration (DDR) 37 


ENQ/DEQ purge routine 32 
initiator use of 33 

Entering commands 37 

Entry to job management 
after IPL 15 
after step execution 16 


Free track queue 53-54 


HALT command 14,37 

Hierarchy support (see main storage 
hierarchy support) 

HOLD command 39,37,14 

HOLD queue 52 

HO (see main storage hirearchy support) 

Hi (see main storage hierarchy support) 


Index .195 


Initial program loading (IPL) 15 
Initialization (see system initialization) 
Initiating task (see initiator/terminator) 
Initiator/terminator 21-34 
flowchart 177 
Input queue 20,52,53 
Interlocks, system 19,52,58 
Interpreter (see reader/interpreter) 
Interpreter entrance list (NEL) 20,50 
Interpreter work area (IWA) 
format and description of 
reader use of 20,21 
IPL (see initial program loading) 
IWA (see interpreter work area) 


69-77 


JCL (see job control language) 

JCLS (see job control language set) 

JCT (see job control table) 

JFCB (see job file control block) 

JFCBX (see job file control block 
extension) 


JMR (see job management record) 
Job class 42,54 
Job control language (JCL) 47-50 


Job 
Job 


control language set (JCLS) 50 
control table (JCT) 
data set integrity use of 28 
format and description of 78-79 
queue management use of 58 © 
system task control use of 50 
Job deletion routine 33 
Job file control block (JFCB) 
format and description of 80-81 
Job file control block extension (JFCBX) 


format and description of 80-81 
Job initiation routine 27-28 
Job management record (JMR) 21 


Job queue 52-60 
initialization 
Job selection routine 
Job step timing 
in the small parition module 
in the step deletion routine 
in the step initiation routine 
Job termination 16 
(also see job deletion routine and small 
partition termination) 


53-54 
22723 


27 
32 
28-29 


Job time limit 28-29 
Large partition 
definition of 21 


LCT (see linkage control table) 
Life-of-task (LOT) block 

creation of 22 

format and description of 80,82 
Link parameter list (LPL) 24-25 
Linkage control table (LCT) 

format and description of 80,83 

job deletion routine use of 33 

job selection routine use of 23 
Linkage table 47,51 
Linkage to queue manager delete routine 35 
Load PSW routines 49 
Local work area (LWA) 
Logical track 53-55 


21 


196 Job Management with MFT (Release 21) 


Logical track header (LTH) 55 
LOT (see life-of-task block) 
LPL (see link parameter list) 
ITH (see logical track header) 


LWA (see local work area) 


M/S resident data area (see master 
scheduler resident data area) 
Main storage hierarchy support 42, 45-46 
Main storage initialization (see system 
initialization) 

Master queue control record 53 

Master scheduler resident data area 
format and description of 84-87 
job selection routine use of 23 
reader use of 21 
System task control use of 47 

Master scheduler resident command 

processor 39-46 

Master scheduler task 
command processing functions 39-46 
initialization functions 13 ,17-18 
TCB 39 

MODE command 14,37 

MODIFY command 14,37 

MONITOR command 14,37 

MOUNT command processing 14,36, 38 

MSGRT routines 124,125 


NEL (see interpreter entrance list) 

NIP (see nucleus initialization program) 
Nucleus initialization program (NIP) 
13,17,42 | 


ONGFX/OFFGFX 120 

ONLINE/OFFLINE 123 

Output work queue 21,52-57 

Output writer (see system output writer) 


Partition 
definition 42-46 
initialization 17 
large 21 


problem program 46 
recovery routine 33 
redefinition 22,43 
small 21 
Partition information block (PIB) 
format and description of 87-89 
job selection routine use of 22 
reader use of 20 
small partition module use of 25 
Svc 34 use of 39 © 
system task control use of 47,51 
writer use of 34 
Passed data set queue (PDQ) 94 
PDQ (see passed data set queue) 
PIB (see partition information block) 
Priority, job 53 
Problem program 
definition of 47 
initialization 27 
interface routine 30 
large partition scheduling 21-36, 46-51 
small partition scheduling 23-27, 46-51 


ca 


ty, 





Procedure library 47 
Protection keys 46, 47 


QCR (see queue control record) 
QMPA (see queue manager parameter area) 
Queue alter routines 39-43 
Queue control record (QCR) 

contents of 53 

format of 53,54 

queue alter routine use of 40 
Queue management 52-60 
Queue manager parameter area (QMPA) 

27-28,51,55 


Reader/Interpreter 19-21 
flowchart 183-185 
resident reader 19-20 
system-assigned transient reader 20 
user-assigned transient reader 20 
Reading task 19 
(also see reader/interpreter) 
READY message 17 
RELEASE command 39,14 
Remote job entry (RJE) queue 52 
RESET command 14, 39 
Restart reader 22 


SCD (see system output class directory) 
Scheduler (see initiator/terminator) 
SCRATCH macro instruction 42 
SCT (see step control table) 
SDT (see start descriptor table) 
SET command 14 
SIOT (see step input/output table) 
Small partition 

definition of 23 


module 25-27 
scheduling 23-27 
termination 25-27 


Small partition information list (SPIL) 
definition of 23 
format and description of 90 
partition recovery routine use of 34 
problem program initialization routine 
use OF 27 
small partition module use of 
small partition scheduling 
use OF 23,24, 25 
step deletion routine use of 33 
system task control use of 51 
SMCA (see system management control area) 
SMF (see system management facility) 
SPIL (see small partition information list) 
Standard writer routine 35 
START command processing 37,38-39,46-51 
differences between system tasks and 
problem programs started from the 
console 47 
for an initiator 19, 23 
for a problem program 19,23, 27,46-51 
for a system task 24-25, 46-51 
Start descriptor table (SDT) 49 
STC (see system task control) 


26,27 


Step control table (SCT) 
format and description of 
job initiation use of 28 
step deletion routine use of 32 
step initiation routine use of 29 

Step deletion 32-33 

Step initiation 28-29 

Step input/output table (SIOT) 
format and description of 92-95 

Step termination (see step deletion) 

Step time limit 28-29 

STIMER macro instruction 
problem program interface routine use 

of 30 
small partition module use of 27 

STOP command 14,37 

STOPMN routines 123,124 

STOP INIT command 38 

Storage protection (see protection keys) 

Svc 29 41 

Svc 34 (see command processing) 


91-92 


SVC 36 37 
Svc 83 30 
Svc 90 53 


SWAP command 
Syntax check 
DEFINE command 42 
queue alter routine 39 
System initialization 13,17-18 
communications task initialization 17 
master scheduler initialization 
routine 17-18 
partition establishment 17 
queue initialization 53-54 
SMF initialization 60-63 
system log initialization 17 
System input reader (see 
reader/interpreter) 
System management control area (SMCA) 30 
System management facility (SMF) 60-63 
comparison of MFT and MVT 60 
data sets 60 
dump routine 60 
initialization 60-63 
records 60 
step initiation routine 28-29 
storage configuration record 
creation 45 | 
Svc 83 60 
TCTIOT construction routine 
user initiation exit routine 
writer 63 
System output class directory (SCD) 
job initiation routine use of 27 
System output writer 34-36 
nonresident 34 
resident 34-35 
System restart 18 
System Task 
definition of 46 
large partition scheduling 21-36, 46-51 
small partition scheduling 24-27, 46-51 
System task control 46-51 
flowchart 192 
job selection routine use of 
small partition module use of 
SYS1.PROCLIB 47 


14,37 


31-32 
29-30 


20,23 
23, 24-25 


Index 197 


SYS1.SYSJOBQE 52 
problem program initialization routine 
use of 27 


Table breakup parameter list 59 
Table breakup routine (TBR) 58-60 
Table queue control record (TQCR) 59 
Task input/output table (TIOT) 
format and description of 94,97 
problem program initialization routine 
use of 31 
small partition routine use of 24-25 
step deletion routine use of 32 
step initiation routine use of 29 
writer use of 35 
TBR (see table breakup routine) 
TCT (see timing control table) 
TCTIOT (see timing control task 
input/output table) 
Termination 
alternate step deletion routine 33 
job deletion routine 33 
small partition 25-27 
step deletion routine 32-33 
TIME BIN macro instruction 30 
Timer queue element (TQE) 88 
small partition module use of 26 
step deletion routine use of 32 
Timer work area 
problem program interface routine use 
of 30 
step deletion routine use of 32 
step initiation routine use of 28-29 
Timing control table (TCT) 30 | 


198 Job Management with MFT (Release 21) 


Timing control task input/output table 
(TCTIOT) 31-32 | 
TIOT (see task input/output table) 
TOCR (see table queue control record) 
TQE (see timer queue element) 
Track stacking 55 | 
Transient queue management routines 60 
Transient reader (see reader/interpreter) 
TTIMER macro instruction 
small partition routine use of 25,27 
step deletion routine use of 32 


UNLOAD command 14,37 
UPL (see user's parameter list) 
User's parameter list 31 


Validity check 45 
VARY commands 14,37 


Wait routine 35 
Work queues 52 
Write-to-programmer (WTP) 
facility 52,64 
small partition module 27 
Write-to-programmer control block (WTPCB) 
format and description of 96 
small partition module use of 27 
Writer (see system output writer) 
Writing task 
(also see system output writer) 
WIP (see write-to-programmer) 
WIPCB (see write-to-programmer control 
block) 








READER'S COMMENT FORM 


IBM System/360 Operating System 
Job Management with MFT 


Program Logic Manual 


Order No. GY2/-7128-7 


Please use this form to express your opinion of this publication. We are interested in your 
comments about its technical accuracy, organization, and completeness. All suggestions 
and comments become the property of IBM. 


Please do not use this form to request technical information or additional copies of publications. 
All such requests should be directed to your IBM representative or to the IBM Branch Office 


serving your locality. 
@ Please indicate your occupation: 


@ How did you use this publication? 
[] Frequently for reference in my work. 
L] Asan introduction to the subject. 
[] As a textbook in a course. 


CL] For specific information on one or two subjects. 


@ Comments (Please include page numbers and give examples.): 


@ Thank you for your comments. No postage necessary if mailed in the U.S.A. 


GY 27-71 28-7 


YOUR COMMENTS, PLEASE ... 


This manual is part of a library that serves as a reference source for systems analysts, 
programmers and operators of IBM systems. Your answers to the questions on the back 
of this form, together with your comments, will help us produce better publications for 
your use. Each reply will be carefully reviewed by the persons responsible for writing 
and publishing this material. All comments and suggestions become the property of IBM. 


Note: Please direct any requests for copies of publications, or for assistance in using your 
IBM system, to your IBM representative or to the IBM branch office serving your locality. 


FIRST CLASS 
PERMIT NO. 81 
POUGHKEEPSIE, N.Y. 





ot i ene el 
BUSINESS REPLY MAIL 
ee 3 
NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 
ee eaa| 
be a a | 
POSTAGE WILL BE PAID BY ... peaoreere: 
eae 
ese es 
IBM Corporation Pree tae eal 
P.O. Box 390 Eas 
Poughkeepsie, N.Y. 12602 
Attention: Programming Systems Publications 
Department D58 
Fold Fold 


SIME 


® 


International Business Machines Corporation 
Data Processing Division 

112 East Post Road, White Plains, N.Y.10601 
(USA Only] 


IBM World Trade Corporation 
821 United Nations Plaza, New York, New York 10017 
[International | 


aul] Buoy 4n> 


Ee ee ee ee ____ ee ee 


(9€-09€S) LAW YdIM juawaBounw gor SO Ogg /waishs 


L-BZIL-LZ0AD OV S°N UE Padulid 








Nee sgeeceie 


GY 27-71 28-7 


TBM 


International Business Machines Corporation 
Data Processing Division 

112 East Post Road, White Plains, N.Y.10601 
(USA Only] 


IBM World Trade Corporation 
821 United Nations Plaza, New York, New York 10017 
[International | 


(9€-098S) LAW YIM JuaweBounw gor SO C9E/waisds 


L-BCIZ-1Z2AD* “VS 1) SE Peieie 


